@dxos/assistant-toolkit 0.8.4-main.ae835ea → 0.8.4-main.bcb3aa67d6

package/dist/lib/neutral/chunk-GAJ6MKJX.mjs

@@ -0,0 +1,363 @@
+import {
+  __export
+} from "./chunk-J5LGTIGS.mjs";
+
+// src/crud/graph.ts
+import * as Tool from "@effect/ai/Tool";
+import * as Toolkit from "@effect/ai/Toolkit";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Function from "effect/Function";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import * as SchemaAST from "effect/SchemaAST";
+import { Entity, Filter, Obj, Query, Type } from "@dxos/echo";
+import { Database } from "@dxos/echo";
+import { ReferenceAnnotationId, RelationSourceDXNId, RelationSourceId, RelationTargetDXNId, RelationTargetId, createObject, getTypeAnnotation, getTypeIdentifierAnnotation } from "@dxos/echo/internal";
+import { isEncodedReference } from "@dxos/echo-protocol";
+import { mapAst } from "@dxos/effect";
+import { ContextQueueService } from "@dxos/functions";
+import { DXN, ObjectId } from "@dxos/keys";
+import { log } from "@dxos/log";
+import { deepMapValues, isNonNullable, trim } from "@dxos/util";
+var __dxlog_file = "/__w/dxos/dxos/packages/core/assistant-toolkit/src/crud/graph.ts";
+var Subgraph = Schema.Struct({
+  /** Objects and relations. */
+  objects: Schema.Array(Schema.Any)
+});
+var findRelatedSchema = async (db, anchor) => {
+  const allSchemas = await db.graph.schemaRegistry.query().run();
+  return allSchemas.filter((schema) => {
+    if (getTypeAnnotation(schema)?.kind !== Entity.Kind.Relation) {
+      return false;
+    }
+    return isSchemaAddressableByDxn(anchor, DXN.parse(getTypeAnnotation(schema).sourceSchema)) || isSchemaAddressableByDxn(anchor, DXN.parse(getTypeAnnotation(schema).targetSchema));
+  }).map((schema) => ({
+    kind: "relation",
+    schema
+  }));
+};
+var isSchemaAddressableByDxn = (schema, dxn) => {
+  if (getTypeIdentifierAnnotation(schema) === dxn.toString()) {
+    return true;
+  }
+  const t = dxn.asTypeDXN();
+  if (t) {
+    return t.type === Type.getTypename(schema);
+  }
+  return false;
+};
+var LocalSearchToolkit = Toolkit.make(Tool.make("search_local_search", {
+  description: "Search the local database for information using a vector index",
+  parameters: {
+    query: Schema.String.annotations({
+      description: "The query to search for. Could be a question or a topic or a set of keywords."
+    })
+  },
+  success: Schema.Unknown,
+  failure: Schema.Never,
+  dependencies: [
+    Database.Service
+  ]
+}));
+var LocalSearchHandler = LocalSearchToolkit.toLayer({
+  search_local_search: Effect.fn(function* ({ query: query2 }) {
+    const objects = yield* Database.runQuery(Query.select(Filter.text(query2, {
+      type: "vector"
+    })));
+    const results = [
+      ...objects
+    ];
+    const option = yield* Effect.serviceOption(ContextQueueService);
+    if (Option.isSome(option)) {
+      const queueObjects = yield* Effect.promise(() => option.value.queue.queryObjects());
+      results.push(...queueObjects);
+    }
+    return trim`
+      <local_context>
+        ${JSON.stringify(results, null, 2)}
+      </local_context>
+    `;
+  })
+});
+var GraphWriterSchema = class extends Context.Tag("@dxos/assistant/GraphWriterSchema")() {
+};
+var makeGraphWriterToolkit = ({ schema }) => {
+  return Toolkit.make(Tool.make("graph_writer", {
+    description: "Write to the local graph database",
+    parameters: createExtractionSchema(schema).fields,
+    success: Schema.Unknown,
+    failure: Schema.Never,
+    dependencies: [
+      Database.Service,
+      ContextQueueService
+    ]
+  }).annotateContext(Context.make(GraphWriterSchema, {
+    schema
+  })));
+};
+var makeGraphWriterHandler = (toolkit, { onAppend } = {}) => {
+  const { schema } = Context.get(toolkit.tools.graph_writer.annotations, GraphWriterSchema);
+  return toolkit.toLayer({
+    graph_writer: Effect.fn(function* (input) {
+      const { db } = yield* Database.Service;
+      const { queue } = yield* ContextQueueService;
+      const data = yield* Effect.promise(() => sanitizeObjects(schema, input, db, queue));
+      yield* Effect.promise(() => queue.append(data));
+      const dxns = data.map((obj) => Obj.getDXN(obj));
+      onAppend?.(dxns);
+      return dxns;
+    })
+  });
+};
+var createExtractionSchema = (types) => {
+  return Schema.Struct({
+    ...Object.fromEntries(types.map(preprocessSchema).map((schema, index) => [
+      `objects_${getSanitizedSchemaName(types[index])}`,
+      Schema.optional(Schema.Array(schema)).annotations({
+        description: `The objects of type: ${Type.getDXN(types[index])?.asTypeDXN().type}. ${SchemaAST.getDescriptionAnnotation(types[index].ast).pipe(Option.getOrElse(() => ""))}`
+      })
+    ]))
+  });
+};
+var getSanitizedSchemaName = (schema) => {
+  return Type.getDXN(schema).asTypeDXN().type.replaceAll(/[^a-zA-Z0-9]+/g, "_");
+};
+var sanitizeObjects = async (types, data, db, queue) => {
+  const entries = types.map((type) => data[`objects_${getSanitizedSchemaName(type)}`]?.map((object) => ({
+    data: object,
+    schema: type
+  })) ?? []).flat();
+  const idMap = /* @__PURE__ */ new Map();
+  const existingIds = /* @__PURE__ */ new Set();
+  const enitties = /* @__PURE__ */ new Map();
+  const resolveId = (id) => {
+    if (ObjectId.isValid(id)) {
+      existingIds.add(id);
+      return DXN.fromLocalObjectId(id);
+    }
+    const mappedId = idMap.get(id);
+    if (mappedId) {
+      return DXN.fromLocalObjectId(mappedId);
+    }
+    return void 0;
+  };
+  const res = entries.map((entry) => {
+    if (ObjectId.isValid(entry.data.id)) {
+      return entry;
+    }
+    idMap.set(entry.data.id, ObjectId.random());
+    entry.data.id = idMap.get(entry.data.id);
+    return entry;
+  }).map((entry) => {
+    const data2 = deepMapValues(entry.data, (value, recurse) => {
+      if (isEncodedReference(value)) {
+        const ref = value["/"];
+        const id = resolveId(ref);
+        if (id) {
+          return {
+            "/": id.toString()
+          };
+        } else {
+          return {
+            "/": `search:?q=${encodeURIComponent(ref)}`
+          };
+        }
+      }
+      return recurse(value);
+    });
+    if (Entity.getKind(entry.schema) === "relation") {
+      const sourceDxn = resolveId(data2.source);
+      if (!sourceDxn) {
+        log.warn("source not found", {
+          source: data2.source
+        }, {
+          F: __dxlog_file,
+          L: 273,
+          S: void 0,
+          C: (f, a) => f(...a)
+        });
+      }
+      const targetDxn = resolveId(data2.target);
+      if (!targetDxn) {
+        log.warn("target not found", {
+          target: data2.target
+        }, {
+          F: __dxlog_file,
+          L: 277,
+          S: void 0,
+          C: (f, a) => f(...a)
+        });
+      }
+      delete data2.source;
+      delete data2.target;
+      data2[RelationSourceDXNId] = sourceDxn;
+      data2[RelationTargetDXNId] = targetDxn;
+    }
+    return {
+      data: data2,
+      schema: entry.schema
+    };
+  }).filter((object) => !existingIds.has(object.data.id));
+  const dbObjects = await db.query(Query.select(Filter.id(...existingIds))).run();
+  const queueObjects = await queue?.getObjectsById([
+    ...existingIds
+  ]) ?? [];
+  const objects = [
+    ...dbObjects,
+    ...queueObjects
+  ].filter(isNonNullable);
+  log.info("objects", {
+    dbObjects,
+    queueObjects,
+    existingIds
+  }, {
+    F: __dxlog_file,
+    L: 298,
+    S: void 0,
+    C: (f, a) => f(...a)
+  });
+  const missing = Array.from(existingIds).filter((id) => !objects.some((object) => object.id === id));
+  if (missing.length > 0) {
+    throw new Error(`Object IDs do not point to existing objects: ${missing.join(", ")}`);
+  }
+  return res.flatMap(({ data: data2, schema }) => {
+    let skip = false;
+    if (RelationSourceDXNId in data2) {
+      const id = data2[RelationSourceDXNId].asEchoDXN()?.echoId;
+      const obj = objects.find((object) => object.id === id) ?? enitties.get(id);
+      if (obj) {
+        delete data2[RelationSourceDXNId];
+        data2[RelationSourceId] = obj;
+      } else {
+        skip = true;
+      }
+    }
+    if (RelationTargetDXNId in data2) {
+      const id = data2[RelationTargetDXNId].asEchoDXN()?.echoId;
+      const obj = objects.find((object) => object.id === id) ?? enitties.get(id);
+      if (obj) {
+        delete data2[RelationTargetDXNId];
+        data2[RelationTargetId] = obj;
+      } else {
+        skip = true;
+      }
+    }
+    if (!skip) {
+      const obj = createObject(schema, data2);
+      enitties.set(obj.id, obj);
+      return [
+        obj
+      ];
+    }
+    return [];
+  });
+};
+var SoftRef = Schema.Struct({
+  "/": Schema.String
+}).annotations({
+  description: "Reference to another object."
+});
+var preprocessSchema = (schema) => {
+  const isRelationSchema = Entity.getKind(schema) === "relation";
+  const go = (ast, visited = /* @__PURE__ */ new Set()) => {
+    if (visited.has(ast)) {
+      return ast;
+    }
+    visited.add(ast);
+    if (SchemaAST.getAnnotation(ast, ReferenceAnnotationId).pipe(Option.isSome)) {
+      return SoftRef.ast;
+    }
+    return mapAst(ast, (child) => go(child, visited));
+  };
+  return Schema.make(mapAst(schema.ast, (ast) => go(ast))).pipe(Schema.omit("id"), Schema.extend(Schema.Struct({
+    id: Schema.String.annotations({
+      description: "The id of this object. Come up with a unique id based on your judgement."
+    })
+  })), isRelationSchema ? Schema.extend(Schema.Struct({
+    source: Schema.String.annotations({
+      description: "The id of the source object for this relation."
+    }),
+    target: Schema.String.annotations({
+      description: "The id of the target object for this relation."
+    })
+  })) : Function.identity);
+};
+
+// src/blueprints/research/types/ResearchGraph.ts
+var ResearchGraph_exports = {};
+__export(ResearchGraph_exports, {
+  LegacyResearchGraph: () => LegacyResearchGraph,
+  ResearchGraph: () => ResearchGraph,
+  contextQueueLayer: () => contextQueueLayer,
+  create: () => create,
+  query: () => query
+});
+import * as Effect2 from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema2 from "effect/Schema";
+import { Database as Database2, Obj as Obj2, Query as Query2, Ref, Type as Type2 } from "@dxos/echo";
+import { SystemTypeAnnotation } from "@dxos/echo/internal";
+import { Queue } from "@dxos/echo-db";
+import { ContextQueueService as ContextQueueService2, QueueService } from "@dxos/functions";
+var LegacyResearchGraph = Schema2.Struct({
+  queue: Ref.Ref(Queue)
+}).pipe(Type2.object({
+  typename: "org.dxos.type.research-graph",
+  version: "0.1.0"
+}), SystemTypeAnnotation.set(true));
+var ResearchGraph = Schema2.Struct({
+  queue: Ref.Ref(Queue)
+}).pipe(Type2.object({
+  typename: "org.dxos.type.researchGraph",
+  version: "0.1.0"
+}), SystemTypeAnnotation.set(true));
+var create = Effect2.fn("createResearchGraph")(function* () {
+  const queue = yield* QueueService.createQueue();
+  return yield* Database2.add(Obj2.make(ResearchGraph, {
+    queue: Ref.fromDXN(queue.dxn)
+  }));
+});
+var query = Effect2.fn("queryResearchGraph")(function* () {
+  const objects = yield* Database2.runQuery(Query2.type(ResearchGraph));
+  return objects.at(0);
+});
+var contextQueueLayer = Layer.unwrapEffect(Effect2.gen(function* () {
+  const researchGraph = (yield* query()) ?? (yield* create());
+  const researchQueue = yield* Database2.load(researchGraph.queue);
+  return ContextQueueService2.layer(researchQueue);
+}));
+
+// src/blueprints/research/types/index.ts
+import { Text } from "@dxos/schema";
+import { Event, HasConnection, HasRelationship, LegacyOrganization, LegacyPerson, Pipeline, Task } from "@dxos/types";
+var ResearchDataTypes = [
+  // Objects
+  Event.Event,
+  Task.Task,
+  Text.Text,
+  // TODO(wittjosiah): Until views (e.g., Table) support relations this needs to be expressed via organization ref.
+  // Employer.Employer,
+  // Organization.Organization,
+  LegacyPerson,
+  LegacyOrganization,
+  Pipeline.Pipeline,
+  // Relations
+  HasRelationship.HasRelationship,
+  HasConnection.HasConnection
+];
+
+export {
+  Subgraph,
+  findRelatedSchema,
+  LocalSearchToolkit,
+  LocalSearchHandler,
+  makeGraphWriterToolkit,
+  makeGraphWriterHandler,
+  createExtractionSchema,
+  getSanitizedSchemaName,
+  sanitizeObjects,
+  ResearchGraph_exports,
+  ResearchDataTypes
+};
+//# sourceMappingURL=chunk-GAJ6MKJX.mjs.map

package/dist/lib/neutral/chunk-GAJ6MKJX.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/crud/graph.ts", "../../../src/blueprints/research/types/ResearchGraph.ts", "../../../src/blueprints/research/types/index.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Tool from '@effect/ai/Tool';\nimport * as Toolkit from '@effect/ai/Toolkit';\nimport * as Context from 'effect/Context';\nimport * as Effect from 'effect/Effect';\nimport * as Function from 'effect/Function';\nimport * as Option from 'effect/Option';\nimport * as Schema from 'effect/Schema';\nimport * as SchemaAST from 'effect/SchemaAST';\n\nimport { Entity, Filter, Obj, Query, Type } from '@dxos/echo';\nimport { Database } from '@dxos/echo';\nimport {\n  ReferenceAnnotationId,\n  RelationSourceDXNId,\n  RelationSourceId,\n  RelationTargetDXNId,\n  RelationTargetId,\n  createObject,\n  getTypeAnnotation,\n  getTypeIdentifierAnnotation,\n} from '@dxos/echo/internal';\nimport { type Queue } from '@dxos/echo-db';\nimport { isEncodedReference } from '@dxos/echo-protocol';\nimport { mapAst } from '@dxos/effect';\nimport { ContextQueueService } from '@dxos/functions';\nimport { DXN, ObjectId } from '@dxos/keys';\nimport { log } from '@dxos/log';\nimport { deepMapValues, isNonNullable, trim } from '@dxos/util';\n\n// TODO(burdon): Unify with the graph schema.\nexport const Subgraph = Schema.Struct({\n  /** Objects and relations. */\n  objects: Schema.Array(Schema.Any),\n});\n\nexport interface Subgraph extends Schema.Schema.Type<typeof Subgraph> {}\n\nexport type RelatedSchema = {\n  schema: Type.AnyEntity;\n  kind: 'reference' | 'relation';\n};\n\n/**\n * Find all schemas that are related to the given schema.\n *\n * @param db\n * @param schema\n * @returns\n */\nexport const findRelatedSchema = async (db: Database.Database, anchor: Type.AnyEntity): Promise<RelatedSchema[]> => {\n  // TODO(dmaretskyi): Query stored schemas.\n  const allSchemas = await db.graph.schemaRegistry.query().run();\n\n  // TODO(dmaretskyi): Also do references.\n  return allSchemas\n    .filter((schema) => {\n      if (getTypeAnnotation(schema)?.kind !== Entity.Kind.Relation) {\n        return false;\n      }\n\n      return (\n        isSchemaAddressableByDxn(anchor, DXN.parse(getTypeAnnotation(schema)!.sourceSchema!)) ||\n        isSchemaAddressableByDxn(anchor, DXN.parse(getTypeAnnotation(schema)!.targetSchema!))\n      );\n    })\n    .map(\n      (schema): RelatedSchema => ({\n        kind: 'relation',\n        schema,\n      }),\n    );\n};\n\n/**\n * Non-strict DXN comparison.\n * Returns true if the DXN could be resolved to the schema.\n */\nconst isSchemaAddressableByDxn = (schema: Type.AnyEntity, dxn: DXN): boolean => {\n  if (getTypeIdentifierAnnotation(schema) === dxn.toString()) {\n    return true;\n  }\n\n  const t = dxn.asTypeDXN();\n  if (t) {\n    return t.type === Type.getTypename(schema);\n  }\n\n  return false;\n};\n\n/**\n * Perform vector search in the local database.\n */\n// TODO(dmaretskyi): Rename `GraphReadToolkit`.\nexport const LocalSearchToolkit = Toolkit.make(\n  Tool.make('search_local_search', {\n    description: 'Search the local database for information using a vector index',\n    parameters: {\n      query: Schema.String.annotations({\n        description: 'The query to search for. Could be a question or a topic or a set of keywords.',\n      }),\n    },\n    success: Schema.Unknown,\n    failure: Schema.Never,\n    dependencies: [Database.Service],\n  }),\n);\n\nexport const LocalSearchHandler = LocalSearchToolkit.toLayer({\n  search_local_search: Effect.fn(function* ({ query }) {\n    const objects = yield* Database.runQuery(Query.select(Filter.text(query, { type: 'vector' })));\n    const results = [...objects];\n\n    const option = yield* Effect.serviceOption(ContextQueueService);\n    if (Option.isSome(option)) {\n      const queueObjects = yield* Effect.promise(() => option.value.queue.queryObjects());\n      // TODO(dmaretskyi): Text search on the queue.\n      results.push(...queueObjects);\n    }\n\n    return trim`\n      <local_context>\n        ${JSON.stringify(results, null, 2)}\n      </local_context>\n    `;\n  }),\n});\n\n/**\n * Attached as an annotation to the writer tool.\n */\nclass GraphWriterSchema extends Context.Tag('@dxos/assistant/GraphWriterSchema')<\n  GraphWriterSchema,\n  {\n    schema: Type.AnyEntity[];\n  }\n>() {}\n\n/**\n * Forms typed objects that can be written to the graph database.\n */\nexport const makeGraphWriterToolkit = ({ schema }: { schema: Type.AnyEntity[] }) => {\n  return Toolkit.make(\n    Tool.make('graph_writer', {\n      description: 'Write to the local graph database',\n      parameters: createExtractionSchema(schema).fields,\n      success: Schema.Unknown,\n      failure: Schema.Never,\n      dependencies: [Database.Service, ContextQueueService],\n    }).annotateContext(Context.make(GraphWriterSchema, { schema })),\n  );\n};\n\nexport const makeGraphWriterHandler = (\n  toolkit: ReturnType<typeof makeGraphWriterToolkit>,\n  {\n    onAppend,\n  }: {\n    onAppend?: (object: DXN[]) => void;\n  } = {},\n) => {\n  const { schema } = Context.get(\n    toolkit.tools.graph_writer.annotations as Context.Context<GraphWriterSchema>,\n    GraphWriterSchema,\n  );\n\n  return toolkit.toLayer({\n    graph_writer: Effect.fn(function* (input) {\n      const { db } = yield* Database.Service;\n      const { queue } = yield* ContextQueueService;\n      const data = yield* Effect.promise(() => sanitizeObjects(schema, input as any, db, queue));\n      yield* Effect.promise(() => queue.append(data as Obj.Unknown[]));\n\n      const dxns = data.map((obj) => Obj.getDXN(obj));\n      onAppend?.(dxns);\n      return dxns;\n    }),\n  });\n};\n\n/**\n * Create a schema for structured data extraction.\n */\nexport const createExtractionSchema = (types: Type.AnyEntity[]) => {\n  return Schema.Struct({\n    ...Object.fromEntries(\n      types.map(preprocessSchema).map((schema, index) => [\n        `objects_${getSanitizedSchemaName(types[index])}`,\n        Schema.optional(Schema.Array(schema)).annotations({\n          description: `The objects of type: ${Type.getDXN(types[index])?.asTypeDXN()!.type}. ${SchemaAST.getDescriptionAnnotation(types[index].ast).pipe(Option.getOrElse(() => ''))}`,\n        }),\n      ]),\n    ),\n  });\n};\n\nexport const getSanitizedSchemaName = (schema: Type.AnyEntity) => {\n  return Type.getDXN(schema)!\n    .asTypeDXN()!\n    .type.replaceAll(/[^a-zA-Z0-9]+/g, '_');\n};\n\nexport const sanitizeObjects = async (\n  types: Type.AnyEntity[],\n  data: Record<string, readonly unknown[]>,\n  db: Database.Database,\n  queue?: Queue,\n): Promise<Obj.Unknown[]> => {\n  const entries = types\n    .map(\n      (type) =>\n        data[`objects_${getSanitizedSchemaName(type)}`]?.map((object: any) => ({\n          data: object,\n          schema: type,\n        })) ?? [],\n    )\n    .flat();\n\n  const idMap = new Map<string, string>();\n  const existingIds = new Set<ObjectId>();\n  const enitties = new Map<ObjectId, Entity.Unknown>();\n\n  const resolveId = (id: string): DXN | undefined => {\n    if (ObjectId.isValid(id)) {\n      existingIds.add(id);\n      return DXN.fromLocalObjectId(id);\n    }\n\n    const mappedId = idMap.get(id);\n    if (mappedId) {\n      return DXN.fromLocalObjectId(mappedId);\n    }\n\n    return undefined;\n  };\n\n  const res = entries\n    .map((entry) => {\n      // This entry mutates existing object.\n      if (ObjectId.isValid(entry.data.id)) {\n        return entry;\n      }\n\n      idMap.set(entry.data.id, ObjectId.random());\n      entry.data.id = idMap.get(entry.data.id);\n      return entry;\n    })\n    .map((entry) => {\n      const data = deepMapValues(entry.data, (value, recurse) => {\n        if (isEncodedReference(value)) {\n          const ref = value['/'];\n          const id = resolveId(ref);\n\n          if (id) {\n            // Link to an existing object.\n            return { '/': id.toString() };\n          } else {\n            // Search URIs?\n            return { '/': `search:?q=${encodeURIComponent(ref)}` };\n          }\n        }\n\n        return recurse(value);\n      });\n\n      if (Entity.getKind(entry.schema) === 'relation') {\n        const sourceDxn = resolveId(data.source);\n        if (!sourceDxn) {\n          log.warn('source not found', { source: data.source });\n        }\n        const targetDxn = resolveId(data.target);\n        if (!targetDxn) {\n          log.warn('target not found', { target: data.target });\n        }\n        delete data.source;\n        delete data.target;\n        data[RelationSourceDXNId] = sourceDxn;\n        data[RelationTargetDXNId] = targetDxn;\n      }\n\n      return {\n        data,\n        schema: entry.schema,\n      };\n    })\n    .filter((object) => !existingIds.has(object.data.id)); // TODO(dmaretskyi): This dissallows updating existing objects.\n\n  // TODO(dmaretskyi): Use ref resolver.\n  const dbObjects = await db.query(Query.select(Filter.id(...existingIds))).run();\n  const queueObjects = (await queue?.getObjectsById([...existingIds])) ?? [];\n  const objects = [...dbObjects, ...queueObjects].filter(isNonNullable);\n\n  // TODO(dmaretskyi): Returns everything if IDs are empty!\n  log.info('objects', { dbObjects, queueObjects, existingIds });\n  const missing = Array.from(existingIds).filter((id) => !objects.some((object) => object.id === id));\n  if (missing.length > 0) {\n    throw new Error(`Object IDs do not point to existing objects: ${missing.join(', ')}`);\n  }\n\n  return res.flatMap(({ data, schema }) => {\n    let skip = false;\n    if (RelationSourceDXNId in data) {\n      const id = (data[RelationSourceDXNId] as DXN).asEchoDXN()?.echoId;\n      const obj = objects.find((object) => object.id === id) ?? enitties.get(id!);\n      if (obj) {\n        delete data[RelationSourceDXNId];\n        data[RelationSourceId] = obj;\n      } else {\n        skip = true;\n      }\n    }\n    if (RelationTargetDXNId in data) {\n      const id = (data[RelationTargetDXNId] as DXN).asEchoDXN()?.echoId;\n      const obj = objects.find((object) => object.id === id) ?? enitties.get(id!);\n      if (obj) {\n        delete data[RelationTargetDXNId];\n        data[RelationTargetId] = obj;\n      } else {\n        skip = true;\n      }\n    }\n    if (!skip) {\n      const obj = createObject(schema, data);\n      enitties.set(obj.id, obj);\n      return [obj];\n    }\n    return [];\n  });\n};\n\nconst SoftRef = Schema.Struct({\n  '/': Schema.String,\n}).annotations({\n  description: 'Reference to another object.',\n});\n\nconst preprocessSchema = (schema: Schema.Schema.AnyNoContext) => {\n  const isRelationSchema = Entity.getKind(schema) === 'relation';\n\n  const go = (ast: SchemaAST.AST, visited = new Set<SchemaAST.AST>()): SchemaAST.AST => {\n    if (visited.has(ast)) {\n      // Already visited this node, prevent infinite recursion.\n      return ast;\n    }\n    visited.add(ast);\n\n    if (SchemaAST.getAnnotation(ast, ReferenceAnnotationId).pipe(Option.isSome)) {\n      return SoftRef.ast;\n    }\n\n    return mapAst(ast, (child) => go(child, visited));\n  };\n\n  return Schema.make<any, any, never>(mapAst(schema.ast, (ast) => go(ast))).pipe(\n    Schema.omit('id'),\n    Schema.extend(\n      Schema.Struct({\n        id: Schema.String.annotations({\n          description: 'The id of this object. Come up with a unique id based on your judgement.',\n        }),\n      }),\n    ),\n    isRelationSchema\n      ? Schema.extend(\n          Schema.Struct({\n            source: Schema.String.annotations({\n              description: 'The id of the source object for this relation.',\n            }),\n            target: Schema.String.annotations({\n              description: 'The id of the target object for this relation.',\n            }),\n          }),\n        )\n      : Function.identity<Schema.Schema.AnyNoContext>,\n  );\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\nimport * as Schema from 'effect/Schema';\n\nimport { Database, Obj, Query, Ref, Type } from '@dxos/echo';\nimport { SystemTypeAnnotation } from '@dxos/echo/internal';\nimport { Queue } from '@dxos/echo-db';\nimport { ContextQueueService, QueueService } from '@dxos/functions';\n\n/** @deprecated Use ResearchGraph instead. */\nexport const LegacyResearchGraph = Schema.Struct({\n  queue: Ref.Ref(Queue),\n}).pipe(\n  Type.object({\n    typename: 'org.dxos.type.research-graph',\n    version: '0.1.0',\n  }),\n  SystemTypeAnnotation.set(true),\n);\n\nexport interface LegacyResearchGraph extends Schema.Schema.Type<typeof LegacyResearchGraph> {}\n\n/**\n * Container for a set of ephemeral research results.\n */\nexport const ResearchGraph = Schema.Struct({\n  queue: Ref.Ref(Queue),\n}).pipe(\n  Type.object({\n    typename: 'org.dxos.type.researchGraph',\n    version: '0.1.0',\n  }),\n  SystemTypeAnnotation.set(true),\n);\n\nexport interface ResearchGraph extends Schema.Schema.Type<typeof ResearchGraph> {}\n\nexport const create: () => Effect.Effect<ResearchGraph, never, Database.Service | QueueService> = Effect.fn(\n  'createResearchGraph',\n)(function* () {\n  const queue = yield* QueueService.createQueue();\n  return yield* Database.add(Obj.make(ResearchGraph, { queue: Ref.fromDXN(queue.dxn) }));\n});\n\nexport const query: () => Effect.Effect<ResearchGraph | undefined, never, Database.Service> = Effect.fn(\n  'queryResearchGraph',\n)(function* () {\n  const objects = yield* Database.runQuery(Query.type(ResearchGraph));\n  return objects.at(0);\n});\n\nexport const contextQueueLayer = Layer.unwrapEffect(\n  Effect.gen(function* () {\n    const researchGraph = (yield* query()) ?? (yield* create());\n    const researchQueue = yield* Database.load(researchGraph.queue);\n    return ContextQueueService.layer(researchQueue);\n  }),\n);\n", "//\n// Copyright 2026 DXOS.org\n//\n\nimport { type Type } from '@dxos/echo';\nimport { Text } from '@dxos/schema';\nimport { Event, HasConnection, HasRelationship, LegacyOrganization, LegacyPerson, Pipeline, Task } from '@dxos/types';\n\nexport * as ResearchGraph from './ResearchGraph';\n\n/**\n * Data types for research.\n */\n// TODO(burdon): This should not be hardcoded.\nexport const ResearchDataTypes: Type.AnyEntity[] = [\n  // Objects\n  Event.Event,\n  Task.Task,\n  Text.Text,\n\n  // TODO(wittjosiah): Until views (e.g., Table) support relations this needs to be expressed via organization ref.\n  // Employer.Employer,\n  // Organization.Organization,\n  LegacyPerson,\n  LegacyOrganization,\n\n  Pipeline.Pipeline,\n\n  // Relations\n  HasRelationship.HasRelationship,\n  HasConnection.HasConnection,\n];\n"],
+  "mappings": "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",
+  "names": ["Tool", "Toolkit", "Context", "Effect", "Function", "Option", "Schema", "SchemaAST", "Entity", "Filter", "Obj", "Query", "Type", "Database", "ReferenceAnnotationId", "RelationSourceDXNId", "RelationSourceId", "RelationTargetDXNId", "RelationTargetId", "createObject", "getTypeAnnotation", "getTypeIdentifierAnnotation", "isEncodedReference", "mapAst", "ContextQueueService", "DXN", "ObjectId", "log", "deepMapValues", "isNonNullable", "trim", "Subgraph", "Struct", "objects", "Array", "Any", "findRelatedSchema", "db", "anchor", "allSchemas", "graph", "schemaRegistry", "query", "run", "filter", "schema", "kind", "Kind", "Relation", "isSchemaAddressableByDxn", "parse", "sourceSchema", "targetSchema", "map", "dxn", "toString", "t", "asTypeDXN", "type", "getTypename", "LocalSearchToolkit", "make", "description", "parameters", "String", "annotations", "success", "Unknown", "failure", "Never", "dependencies", "Service", "LocalSearchHandler", "toLayer", "search_local_search", "fn", "runQuery", "select", "text", "results", "option", "serviceOption", "isSome", "queueObjects", "promise", "value", "queue", "queryObjects", "push", "JSON", "stringify", "GraphWriterSchema", "Tag", "makeGraphWriterToolkit", "createExtractionSchema", "fields", "annotateContext", "makeGraphWriterHandler", "toolkit", "onAppend", "get", "tools", "graph_writer", "input", "data", "sanitizeObjects", "append", "dxns", "obj", "getDXN", "types", "Object", "fromEntries", "preprocessSchema", "index", "getSanitizedSchemaName", "optional", "getDescriptionAnnotation", "ast", "pipe", "getOrElse", "replaceAll", "entries", "object", "flat", "idMap", "Map", "existingIds", "Set", "enitties", "resolveId", "id", "isValid", "add", "fromLocalObjectId", "mappedId", "undefined", "res", "entry", "set", "random", "recurse", "ref", "encodeURIComponent", "getKind", "sourceDxn", "source", "warn", "targetDxn", "target", "has", "dbObjects", "getObjectsById", "info", "missing", "from", "some", "length", "Error", "join", "flatMap", "skip", "asEchoDXN", "echoId", "find", "SoftRef", "isRelationSchema", "go", "visited", "getAnnotation", "child", "omit", "extend", "identity", "Effect", "Layer", "Schema", "Database", "Obj", "Query", "Ref", "Type", "SystemTypeAnnotation", "Queue", "ContextQueueService", "QueueService", "LegacyResearchGraph", "Struct", "queue", "Ref", "Queue", "pipe", "Type", "object", "typename", "version", "SystemTypeAnnotation", "set", "ResearchGraph", "create", "fn", "QueueService", "createQueue", "Database", "add", "Obj", "make", "fromDXN", "dxn", "query", "objects", "runQuery", "Query", "type", "at", "contextQueueLayer", "unwrapEffect", "gen", "researchGraph", "researchQueue", "load", "ContextQueueService", "layer", "Text", "Event", "HasConnection", "HasRelationship", "LegacyOrganization", "LegacyPerson", "Pipeline", "Task", "ResearchDataTypes", "Event", "Task", "Text", "LegacyPerson", "LegacyOrganization", "Pipeline", "HasRelationship", "HasConnection"]
+}

package/dist/lib/neutral/chunk-HEFG73F2.mjs

@@ -0,0 +1,53 @@
+import {
+  Chat
+} from "./chunk-VBSCQN37.mjs";
+
+// src/functions/agent/definitions.ts
+import * as Schema from "effect/Schema";
+import { AiService, ModelName, ToolExecutionService, ToolResolverService } from "@dxos/ai";
+import { Prompt } from "@dxos/blueprints";
+import { Database, Ref } from "@dxos/echo";
+import { FunctionInvocationService, QueueService, TracingService } from "@dxos/functions";
+import { Operation } from "@dxos/operation";
+var AgentPrompt = Operation.make({
+  meta: {
+    key: "org.dxos.function.prompt",
+    name: "Agent",
+    description: "Agentic worker that executes a provided prompt using blueprints and tools."
+  },
+  input: Schema.Struct({
+    prompt: Ref.Ref(Prompt.Prompt),
+    // TODO(dmaretskyi): Remove.
+    systemPrompt: Schema.optional(Ref.Ref(Prompt.Prompt)),
+    /**
+    * When set, runs in this chat (history, queue, and bound context). Prompt blueprints and context objects are merged into the conversation for this request.
+    */
+    chat: Schema.optional(Ref.Ref(Chat)),
+    /**
+    * @default @anthropic/claude-opus-4-0
+    */
+    model: Schema.optional(ModelName),
+    /**
+    * Input object or data.
+    * References get auto-resolved.
+    */
+    input: Schema.Any.pipe(Schema.annotations({
+      title: "Input"
+    }))
+  }),
+  output: Schema.Any,
+  services: [
+    AiService.AiService,
+    Database.Service,
+    QueueService,
+    TracingService,
+    ToolExecutionService,
+    ToolResolverService,
+    FunctionInvocationService
+  ]
+});
+
+export {
+  AgentPrompt
+};
+//# sourceMappingURL=chunk-HEFG73F2.mjs.map

package/dist/lib/neutral/chunk-HEFG73F2.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/functions/agent/definitions.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { AiService, ModelName, ToolExecutionService, ToolResolverService } from '@dxos/ai';\nimport { Prompt } from '@dxos/blueprints';\nimport { Database, Ref } from '@dxos/echo';\nimport { FunctionInvocationService, QueueService, TracingService } from '@dxos/functions';\nimport { Operation } from '@dxos/operation';\n\nimport * as Chat from '../../types/Chat';\n\nexport const AgentPrompt = Operation.make({\n  meta: {\n    key: 'org.dxos.function.prompt',\n    name: 'Agent',\n    description: 'Agentic worker that executes a provided prompt using blueprints and tools.',\n  },\n  input: Schema.Struct({\n    prompt: Ref.Ref(Prompt.Prompt),\n\n    // TODO(dmaretskyi): Remove.\n    systemPrompt: Schema.optional(Ref.Ref(Prompt.Prompt)),\n\n    /**\n     * When set, runs in this chat (history, queue, and bound context). Prompt blueprints and context objects are merged into the conversation for this request.\n     */\n    chat: Schema.optional(Ref.Ref(Chat.Chat)),\n\n    /**\n     * @default @anthropic/claude-opus-4-0\n     */\n\n    model: Schema.optional(ModelName),\n    /**\n     * Input object or data.\n     * References get auto-resolved.\n     */\n    input: Schema.Any.pipe(Schema.annotations({ title: 'Input' })),\n  }),\n  output: Schema.Any,\n  services: [\n    AiService.AiService,\n    Database.Service,\n    QueueService,\n    TracingService,\n    ToolExecutionService,\n    ToolResolverService,\n    FunctionInvocationService,\n  ],\n});\n"],
+  "mappings": ";;;;;AAIA,YAAYA,YAAY;AAExB,SAASC,WAAWC,WAAWC,sBAAsBC,2BAA2B;AAChF,SAASC,cAAc;AACvB,SAASC,UAAUC,WAAW;AAC9B,SAASC,2BAA2BC,cAAcC,sBAAsB;AACxE,SAASC,iBAAiB;AAInB,IAAMC,cAAcC,UAAUC,KAAK;EACxCC,MAAM;IACJC,KAAK;IACLC,MAAM;IACNC,aAAa;EACf;EACAC,OAAcC,cAAO;IACnBC,QAAQC,IAAIA,IAAIC,OAAOA,MAAM;;IAG7BC,cAAqBC,gBAASH,IAAIA,IAAIC,OAAOA,MAAM,CAAA;;;;IAKnDG,MAAaD,gBAASH,IAAIA,IAASK,IAAI,CAAA;;;;IAMvCC,OAAcH,gBAASI,SAAAA;;;;;IAKvBV,OAAcW,WAAIC,KAAYC,mBAAY;MAAEC,OAAO;IAAQ,CAAA,CAAA;EAC7D,CAAA;EACAC,QAAeJ;EACfK,UAAU;IACRC,UAAUA;IACVC,SAASC;IACTC;IACAC;IACAC;IACAC;IACAC;;AAEJ,CAAA;",
+  "names": ["Schema", "AiService", "ModelName", "ToolExecutionService", "ToolResolverService", "Prompt", "Database", "Ref", "FunctionInvocationService", "QueueService", "TracingService", "Operation", "AgentPrompt", "Operation", "make", "meta", "key", "name", "description", "input", "Struct", "prompt", "Ref", "Prompt", "systemPrompt", "optional", "chat", "Chat", "model", "ModelName", "Any", "pipe", "annotations", "title", "output", "services", "AiService", "Database", "Service", "QueueService", "TracingService", "ToolExecutionService", "ToolResolverService", "FunctionInvocationService"]
+}

package/dist/lib/neutral/chunk-HZM3HNAS.mjs

@@ -0,0 +1,78 @@
+// src/sync/sync.ts
+import * as Effect from "effect/Effect";
+import { Filter, Obj, Query, Ref } from "@dxos/echo";
+import { Database } from "@dxos/echo";
+import { failedInvariant } from "@dxos/invariant";
+import { log } from "@dxos/log";
+var __dxlog_file = "/__w/dxos/dxos/packages/core/assistant-toolkit/src/sync/sync.ts";
+var syncObjects = Effect.fn("syncObjects")(function* (objs, { foreignKeyId }) {
+  return yield* Effect.forEach(objs, Effect.fnUntraced(function* (obj) {
+    for (const key of Object.keys(obj)) {
+      if (typeof key !== "string" || key === "id") continue;
+      if (!Ref.isRef(obj[key])) continue;
+      const ref = obj[key];
+      if (!ref.target) continue;
+      if (Obj.getDXN(ref.target).isLocalObjectId()) {
+        const [target] = yield* syncObjects([
+          ref.target
+        ], {
+          foreignKeyId
+        });
+        obj[key] = Ref.make(target);
+      }
+    }
+    const schema = Obj.getSchema(obj) ?? failedInvariant("No schema.");
+    const foreignId = Obj.getKeys(obj, foreignKeyId)[0]?.id ?? failedInvariant("No foreign key.");
+    const [existing] = yield* Database.runQuery(Query.select(Filter.foreignKeys(schema, [
+      {
+        source: foreignKeyId,
+        id: foreignId
+      }
+    ])));
+    log("sync object", {
+      type: Obj.getTypename(obj),
+      foreignId,
+      existing: existing ? Obj.getDXN(existing) : void 0
+    }, {
+      F: __dxlog_file,
+      L: 48,
+      S: this,
+      C: (f, a) => f(...a)
+    });
+    if (!existing) {
+      yield* Database.add(obj);
+      return obj;
+    } else {
+      copyObjectData(existing, obj);
+      return existing;
+    }
+  }), {
+    concurrency: 1
+  });
+});
+var copyObjectData = (existing, newObj) => {
+  Obj.change(existing, (obj) => {
+    for (const key of Object.keys(newObj)) {
+      if (typeof key !== "string" || key === "id") continue;
+      if (typeof newObj[key] !== "string" && typeof newObj[key] !== "number" && typeof newObj[key] !== "boolean" && !Ref.isRef(newObj[key])) continue;
+      obj[key] = newObj[key];
+    }
+    for (const key of Object.keys(obj)) {
+      if (typeof key !== "string" || key === "id") continue;
+      if (!(key in newObj)) {
+        delete obj[key];
+      }
+    }
+    for (const foreignKey of Obj.getMeta(newObj).keys) {
+      Obj.deleteKeys(obj, foreignKey.source);
+      Obj.getMeta(obj).keys.push({
+        ...foreignKey
+      });
+    }
+  });
+};
+
+export {
+  syncObjects
+};
+//# sourceMappingURL=chunk-HZM3HNAS.mjs.map

package/dist/lib/neutral/chunk-HZM3HNAS.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/sync/sync.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Filter, Obj, Query, Ref } from '@dxos/echo';\nimport { Database } from '@dxos/echo';\nimport { failedInvariant } from '@dxos/invariant';\nimport { log } from '@dxos/log';\n\n/**\n * Syncs objects to the database.\n * If there's an object with a matching foreign key in the database, it will be updated.\n * Otherwise, a new object will be added.\n * Recursively syncs top-level refs.\n *\n * @param opts.foreignKeyId - The key to use for matching objects.\n */\nexport const syncObjects: (\n  objs: Obj.Unknown[],\n  opts: { foreignKeyId: string },\n) => Effect.Effect<Obj.Unknown[], never, Database.Service> = Effect.fn('syncObjects')(function* (\n  objs,\n  { foreignKeyId },\n) {\n  return yield* Effect.forEach(\n    objs,\n    Effect.fnUntraced(function* (obj) {\n      // Sync referenced objects.\n      for (const key of Object.keys(obj)) {\n        if (typeof key !== 'string' || key === 'id') continue;\n        if (!Ref.isRef((obj as any)[key])) continue;\n        const ref: Ref.Unknown = (obj as any)[key];\n        if (!ref.target) continue;\n        if (Obj.getDXN(ref.target).isLocalObjectId()) {\n          // obj not persisted to db.\n          const [target] = yield* syncObjects([ref.target], { foreignKeyId });\n          (obj as any)[key] = Ref.make(target);\n        }\n      }\n\n      const schema = Obj.getSchema(obj) ?? failedInvariant('No schema.');\n      const foreignId = Obj.getKeys(obj, foreignKeyId)[0]?.id ?? failedInvariant('No foreign key.');\n      const [existing] = yield* Database.runQuery(\n        Query.select(Filter.foreignKeys(schema, [{ source: foreignKeyId, id: foreignId }])),\n      );\n      log('sync object', {\n        type: Obj.getTypename(obj),\n        foreignId,\n        existing: existing ? Obj.getDXN(existing) : undefined,\n      });\n      if (!existing) {\n        yield* Database.add(obj);\n        return obj;\n      } else {\n        copyObjectData(existing, obj);\n        return existing;\n      }\n    }),\n    { concurrency: 1 },\n  );\n});\n\nconst copyObjectData = (existing: Obj.Unknown, newObj: Obj.Unknown) => {\n  Obj.change(existing, (obj) => {\n    // Copy properties from newObj to existing.\n    for (const key of Object.keys(newObj)) {\n      if (typeof key !== 'string' || key === 'id') continue;\n      if (\n        typeof (newObj as any)[key] !== 'string' &&\n        typeof (newObj as any)[key] !== 'number' &&\n        typeof (newObj as any)[key] !== 'boolean' &&\n        !Ref.isRef((newObj as any)[key])\n      )\n        continue;\n      (obj as any)[key] = (newObj as any)[key];\n    }\n\n    // Delete properties that don't exist in newObj.\n    for (const key of Object.keys(obj)) {\n      if (typeof key !== 'string' || key === 'id') continue;\n      if (!(key in newObj)) {\n        delete (obj as any)[key];\n      }\n    }\n\n    // Update foreign keys.\n    for (const foreignKey of Obj.getMeta(newObj).keys) {\n      Obj.deleteKeys(obj, foreignKey.source);\n      // TODO(dmaretskyi): Doesn't work: `Obj.getMeta(existing).keys.push(foreignKey);`\n      Obj.getMeta(obj).keys.push({ ...foreignKey });\n    }\n  });\n};\n"],
+  "mappings": ";AAIA,YAAYA,YAAY;AAExB,SAASC,QAAQC,KAAKC,OAAOC,WAAW;AACxC,SAASC,gBAAgB;AACzB,SAASC,uBAAuB;AAChC,SAASC,WAAW;;AAUb,IAAMC,cAGuDC,UAAG,aAAA,EAAe,WACpFC,MACA,EAAEC,aAAY,GAAE;AAEhB,SAAO,OAAcC,eACnBF,MACOG,kBAAW,WAAWC,KAAG;AAE9B,eAAWC,OAAOC,OAAOC,KAAKH,GAAAA,GAAM;AAClC,UAAI,OAAOC,QAAQ,YAAYA,QAAQ,KAAM;AAC7C,UAAI,CAACX,IAAIc,MAAOJ,IAAYC,GAAAA,CAAI,EAAG;AACnC,YAAMI,MAAoBL,IAAYC,GAAAA;AACtC,UAAI,CAACI,IAAIC,OAAQ;AACjB,UAAIlB,IAAImB,OAAOF,IAAIC,MAAM,EAAEE,gBAAe,GAAI;AAE5C,cAAM,CAACF,MAAAA,IAAU,OAAOZ,YAAY;UAACW,IAAIC;WAAS;UAAET;QAAa,CAAA;AAChEG,YAAYC,GAAAA,IAAOX,IAAImB,KAAKH,MAAAA;MAC/B;IACF;AAEA,UAAMI,SAAStB,IAAIuB,UAAUX,GAAAA,KAAQR,gBAAgB,YAAA;AACrD,UAAMoB,YAAYxB,IAAIyB,QAAQb,KAAKH,YAAAA,EAAc,CAAA,GAAIiB,MAAMtB,gBAAgB,iBAAA;AAC3E,UAAM,CAACuB,QAAAA,IAAY,OAAOxB,SAASyB,SACjC3B,MAAM4B,OAAO9B,OAAO+B,YAAYR,QAAQ;MAAC;QAAES,QAAQtB;QAAciB,IAAIF;MAAU;KAAE,CAAA,CAAA;AAEnFnB,QAAI,eAAe;MACjB2B,MAAMhC,IAAIiC,YAAYrB,GAAAA;MACtBY;MACAG,UAAUA,WAAW3B,IAAImB,OAAOQ,QAAAA,IAAYO;IAC9C,GAAA;;;;;;AACA,QAAI,CAACP,UAAU;AACb,aAAOxB,SAASgC,IAAIvB,GAAAA;AACpB,aAAOA;IACT,OAAO;AACLwB,qBAAeT,UAAUf,GAAAA;AACzB,aAAOe;IACT;EACF,CAAA,GACA;IAAEU,aAAa;EAAE,CAAA;AAErB,CAAA;AAEA,IAAMD,iBAAiB,CAACT,UAAuBW,WAAAA;AAC7CtC,MAAIuC,OAAOZ,UAAU,CAACf,QAAAA;AAEpB,eAAWC,OAAOC,OAAOC,KAAKuB,MAAAA,GAAS;AACrC,UAAI,OAAOzB,QAAQ,YAAYA,QAAQ,KAAM;AAC7C,UACE,OAAQyB,OAAezB,GAAAA,MAAS,YAChC,OAAQyB,OAAezB,GAAAA,MAAS,YAChC,OAAQyB,OAAezB,GAAAA,MAAS,aAChC,CAACX,IAAIc,MAAOsB,OAAezB,GAAAA,CAAI,EAE/B;AACDD,UAAYC,GAAAA,IAAQyB,OAAezB,GAAAA;IACtC;AAGA,eAAWA,OAAOC,OAAOC,KAAKH,GAAAA,GAAM;AAClC,UAAI,OAAOC,QAAQ,YAAYA,QAAQ,KAAM;AAC7C,UAAI,EAAEA,OAAOyB,SAAS;AACpB,eAAQ1B,IAAYC,GAAAA;MACtB;IACF;AAGA,eAAW2B,cAAcxC,IAAIyC,QAAQH,MAAAA,EAAQvB,MAAM;AACjDf,UAAI0C,WAAW9B,KAAK4B,WAAWT,MAAM;AAErC/B,UAAIyC,QAAQ7B,GAAAA,EAAKG,KAAK4B,KAAK;QAAE,GAAGH;MAAW,CAAA;IAC7C;EACF,CAAA;AACF;",
+  "names": ["Effect", "Filter", "Obj", "Query", "Ref", "Database", "failedInvariant", "log", "syncObjects", "fn", "objs", "foreignKeyId", "forEach", "fnUntraced", "obj", "key", "Object", "keys", "isRef", "ref", "target", "getDXN", "isLocalObjectId", "make", "schema", "getSchema", "foreignId", "getKeys", "id", "existing", "runQuery", "select", "foreignKeys", "source", "type", "getTypename", "undefined", "add", "copyObjectData", "concurrency", "newObj", "change", "foreignKey", "getMeta", "deleteKeys", "push"]
+}