@dxos/assistant-toolkit 0.8.4-main.72ec0f3 → 0.8.4-main.7996785055

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

@@ -0,0 +1,356 @@
+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, {
+  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 ResearchGraph = Schema2.Struct({
+  queue: Ref.Ref(Queue)
+}).pipe(Type2.object({
+  typename: "org.dxos.type.research-graph",
+  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-DHNOQBPL.mjs.map

package/dist/lib/neutral/chunk-DHNOQBPL.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/**\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.research-graph',\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", "ResearchGraph", "Struct", "queue", "Ref", "Queue", "pipe", "Type", "object", "typename", "version", "SystemTypeAnnotation", "set", "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-FHRBPWX5.mjs

@@ -0,0 +1,140 @@
+import {
+  Plan_exports
+} from "./chunk-RMHH7HYC.mjs";
+
+// src/blueprints/planning/functions/definitions.ts
+import * as Schema from "effect/Schema";
+import { AiContextService } from "@dxos/assistant";
+import { Database } from "@dxos/echo";
+import { Operation } from "@dxos/operation";
+import { trim } from "@dxos/util";
+var INSTRUCTIONS = trim`
+TASK MANAGEMENT TOOL - USAGE GUIDELINES
+
+This tool maintains an organized task list during work sessions to track progress, break down objectives, and ensure thoroughness. After creating initial tasks, update them silently without announcing changes to the user.
+
+=== CORE USAGE PRINCIPLES ===
+
+Create and manage tasks for: multi-step objectives requiring 3+ distinct actions, complex projects needing careful sequencing, user requests for task organization, multiple deliverables provided together, new instructions (capture as tasks immediately with new IDs), completed work (mark done and add follow-ups), and active work (mark as 'in-progress', limit one at a time).
+
+Skip task management for: single straightforward actions, simple requests achievable in 1-2 steps, informational queries, quick lookups or clarifications, and avoid creating verification tasks unless requested.
+
+=== TOOL SPECIFICATION ===
+
+update-tasks requires an array of task objects. Each task object contains:
+- id (string, required): unique identifier like "task_1" or "research_sources"
+- title (string, optional): update to clarify or refine task description
+- status (string, optional): 'todo' | 'in-progress' | 'done'
+
+Task status meanings: 'todo' means not yet started, 'in-progress' means currently being worked on, 'done' means completed successfully.
+
+=== OPERATIONAL GUIDELINES ===
+
+Update tasks in real-time as work progresses. Mark tasks 'done' immediately upon completion. Maintain only ONE task with 'in-progress' status at a time. Complete current tasks before starting new ones. Use specific, actionable task titles. Break complex work into manageable logical pieces. Batch task updates with other actions when possible for efficiency.
+
+=== USAGE EXAMPLES ===
+
+<example type="research_project">
+<user_message>I need to research sustainable packaging options and write a report comparing costs and environmental impact.</user_message>
+<assistant_action>
+Creates tasks:
+1. {id: "research_materials", title: "Research sustainable packaging materials", status: "in-progress"}
+2. {id: "compare_costs", title: "Compile cost comparison data", status: "todo"}
+3. {id: "assess_impact", title: "Evaluate environmental impact metrics", status: "todo"}
+4. {id: "draft_report", title: "Write comparative analysis report", status: "todo"}
+
+Begins research work immediately in same response.
+</assistant_action>
+<reasoning>Multi-phase project requiring systematic tracking across research, analysis, and writing stages.</reasoning>
+</example>
+
+<example type="event_planning">
+<user_message>Help me plan a team retreat - venue, agenda, catering, and send invitations.</user_message>
+<assistant_action>
+Creates tasks:
+1. {id: "venue_options", title: "Research and recommend venues", status: "in-progress"}
+2. {id: "draft_agenda", title: "Create retreat agenda", status: "todo"}
+3. {id: "arrange_catering", title: "Coordinate catering options", status: "todo"}
+4. {id: "send_invites", title: "Draft and send invitations", status: "todo"}
+</assistant_action>
+<reasoning>Multiple distinct deliverables with dependencies requiring organized tracking.</reasoning>
+</example>
+
+<example type="document_analysis">
+<user_message>Review this 30-page contract for key terms, risks, and negotiation points.</user_message>
+<assistant_action>
+Creates tasks:
+1. {id: "extract_key_terms", title: "Identify key contractual terms", status: "in-progress"}
+2. {id: "flag_risks", title: "Flag potential risks and liabilities", status: "todo"}
+3. {id: "negotiation_points", title: "Compile negotiation recommendations", status: "todo"}
+4. {id: "summary_doc", title: "Prepare executive summary", status: "todo"}
+</assistant_action>
+<reasoning>Substantial analysis work requiring methodical breakdown and systematic review.</reasoning>
+</example>
+
+<example type="multiple_deliverables">
+<user_message>I need: 1) competitor analysis for three companies, 2) SWOT analysis, 3) market positioning recommendations.</user_message>
+<assistant_action>
+Creates tasks:
+1. {id: "competitor_research", title: "Research three competitor companies", status: "in-progress"}
+2. {id: "swot_analysis", title: "Develop SWOT analysis", status: "todo"}
+3. {id: "positioning_recs", title: "Create market positioning recommendations", status: "todo"}
+</assistant_action>
+<reasoning>User provided numbered list of distinct deliverables requiring separate effort.</reasoning>
+</example>
+
+<example type="skip_simple_question">
+<user_message>What's the difference between renewable and sustainable energy?</user_message>
+<assistant_action>Provides explanation directly without creating tasks.</assistant_action>
+<reasoning>Informational request with no actionable work to complete or track.</reasoning>
+</example>
+
+<example type="skip_quick_lookup">
+<user_message>Find the population of Tokyo.</user_message>
+<assistant_action>Searches and provides answer without task tracking.</assistant_action>
+<reasoning>Single straightforward lookup completable immediately.</reasoning>
+</example>
+
+<example type="skip_trivial_task">
+<user_message>Summarize this 2-paragraph email.</user_message>
+<assistant_action>Provides summary directly without creating tasks.</assistant_action>
+<reasoning>Single simple action requiring no breakdown or progress tracking.</reasoning>
+</example>
+
+<example type="skip_single_action">
+<user_message>Check if my flight is on time.</user_message>
+<assistant_action>Performs lookup and reports status without task management.</assistant_action>
+<reasoning>One-step action with immediate completion, no organizational benefit from tasks.</reasoning>
+</example>
+
+=== BEST PRACTICES ===
+
+For task creation: use descriptive unique IDs reflecting the work, start first task as 'in-progress', batch initial creation with beginning work. For progress tracking: update status immediately upon completion, keep only one 'in-progress' task unless parallel work is natural, add follow-up tasks as they emerge. For task breakdown: aim for reasonably-scoped tasks, group related small actions into logical units, split tasks requiring different approaches.
+
+When uncertain whether to use task management, err on the side of creating tasks. Proactive organization demonstrates thoroughness and ensures comprehensive work completion.
+`;
+var TaskProps = Schema.Struct({
+  id: Plan_exports.TaskId,
+  title: Schema.String,
+  status: Schema.Literal("todo", "in-progress", "done")
+});
+var UpdateTasks = Operation.make({
+  meta: {
+    key: "org.dxos.function.planning.update-tasks",
+    name: "Update tasks",
+    description: INSTRUCTIONS
+  },
+  input: Schema.Struct({
+    tasks: Schema.Array(TaskProps)
+  }),
+  output: Schema.Any,
+  services: [
+    AiContextService,
+    Database.Service
+  ]
+});
+
+export {
+  UpdateTasks
+};
+//# sourceMappingURL=chunk-FHRBPWX5.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/blueprints/planning/functions/definitions.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { AiContextService } from '@dxos/assistant';\nimport { Database } from '@dxos/echo';\nimport { Operation } from '@dxos/operation';\nimport { trim } from '@dxos/util';\n\nimport { Plan } from '../../../types';\n\nconst INSTRUCTIONS = trim`\nTASK MANAGEMENT TOOL - USAGE GUIDELINES\n\nThis tool maintains an organized task list during work sessions to track progress, break down objectives, and ensure thoroughness. After creating initial tasks, update them silently without announcing changes to the user.\n\n=== CORE USAGE PRINCIPLES ===\n\nCreate and manage tasks for: multi-step objectives requiring 3+ distinct actions, complex projects needing careful sequencing, user requests for task organization, multiple deliverables provided together, new instructions (capture as tasks immediately with new IDs), completed work (mark done and add follow-ups), and active work (mark as 'in-progress', limit one at a time).\n\nSkip task management for: single straightforward actions, simple requests achievable in 1-2 steps, informational queries, quick lookups or clarifications, and avoid creating verification tasks unless requested.\n\n=== TOOL SPECIFICATION ===\n\nupdate-tasks requires an array of task objects. Each task object contains:\n- id (string, required): unique identifier like \"task_1\" or \"research_sources\"\n- title (string, optional): update to clarify or refine task description\n- status (string, optional): 'todo' | 'in-progress' | 'done'\n\nTask status meanings: 'todo' means not yet started, 'in-progress' means currently being worked on, 'done' means completed successfully.\n\n=== OPERATIONAL GUIDELINES ===\n\nUpdate tasks in real-time as work progresses. Mark tasks 'done' immediately upon completion. Maintain only ONE task with 'in-progress' status at a time. Complete current tasks before starting new ones. Use specific, actionable task titles. Break complex work into manageable logical pieces. Batch task updates with other actions when possible for efficiency.\n\n=== USAGE EXAMPLES ===\n\n<example type=\"research_project\">\n<user_message>I need to research sustainable packaging options and write a report comparing costs and environmental impact.</user_message>\n<assistant_action>\nCreates tasks:\n1. {id: \"research_materials\", title: \"Research sustainable packaging materials\", status: \"in-progress\"}\n2. {id: \"compare_costs\", title: \"Compile cost comparison data\", status: \"todo\"}\n3. {id: \"assess_impact\", title: \"Evaluate environmental impact metrics\", status: \"todo\"}\n4. {id: \"draft_report\", title: \"Write comparative analysis report\", status: \"todo\"}\n\nBegins research work immediately in same response.\n</assistant_action>\n<reasoning>Multi-phase project requiring systematic tracking across research, analysis, and writing stages.</reasoning>\n</example>\n\n<example type=\"event_planning\">\n<user_message>Help me plan a team retreat - venue, agenda, catering, and send invitations.</user_message>\n<assistant_action>\nCreates tasks:\n1. {id: \"venue_options\", title: \"Research and recommend venues\", status: \"in-progress\"}\n2. {id: \"draft_agenda\", title: \"Create retreat agenda\", status: \"todo\"}\n3. {id: \"arrange_catering\", title: \"Coordinate catering options\", status: \"todo\"}\n4. {id: \"send_invites\", title: \"Draft and send invitations\", status: \"todo\"}\n</assistant_action>\n<reasoning>Multiple distinct deliverables with dependencies requiring organized tracking.</reasoning>\n</example>\n\n<example type=\"document_analysis\">\n<user_message>Review this 30-page contract for key terms, risks, and negotiation points.</user_message>\n<assistant_action>\nCreates tasks:\n1. {id: \"extract_key_terms\", title: \"Identify key contractual terms\", status: \"in-progress\"}\n2. {id: \"flag_risks\", title: \"Flag potential risks and liabilities\", status: \"todo\"}\n3. {id: \"negotiation_points\", title: \"Compile negotiation recommendations\", status: \"todo\"}\n4. {id: \"summary_doc\", title: \"Prepare executive summary\", status: \"todo\"}\n</assistant_action>\n<reasoning>Substantial analysis work requiring methodical breakdown and systematic review.</reasoning>\n</example>\n\n<example type=\"multiple_deliverables\">\n<user_message>I need: 1) competitor analysis for three companies, 2) SWOT analysis, 3) market positioning recommendations.</user_message>\n<assistant_action>\nCreates tasks:\n1. {id: \"competitor_research\", title: \"Research three competitor companies\", status: \"in-progress\"}\n2. {id: \"swot_analysis\", title: \"Develop SWOT analysis\", status: \"todo\"}\n3. {id: \"positioning_recs\", title: \"Create market positioning recommendations\", status: \"todo\"}\n</assistant_action>\n<reasoning>User provided numbered list of distinct deliverables requiring separate effort.</reasoning>\n</example>\n\n<example type=\"skip_simple_question\">\n<user_message>What's the difference between renewable and sustainable energy?</user_message>\n<assistant_action>Provides explanation directly without creating tasks.</assistant_action>\n<reasoning>Informational request with no actionable work to complete or track.</reasoning>\n</example>\n\n<example type=\"skip_quick_lookup\">\n<user_message>Find the population of Tokyo.</user_message>\n<assistant_action>Searches and provides answer without task tracking.</assistant_action>\n<reasoning>Single straightforward lookup completable immediately.</reasoning>\n</example>\n\n<example type=\"skip_trivial_task\">\n<user_message>Summarize this 2-paragraph email.</user_message>\n<assistant_action>Provides summary directly without creating tasks.</assistant_action>\n<reasoning>Single simple action requiring no breakdown or progress tracking.</reasoning>\n</example>\n\n<example type=\"skip_single_action\">\n<user_message>Check if my flight is on time.</user_message>\n<assistant_action>Performs lookup and reports status without task management.</assistant_action>\n<reasoning>One-step action with immediate completion, no organizational benefit from tasks.</reasoning>\n</example>\n\n=== BEST PRACTICES ===\n\nFor task creation: use descriptive unique IDs reflecting the work, start first task as 'in-progress', batch initial creation with beginning work. For progress tracking: update status immediately upon completion, keep only one 'in-progress' task unless parallel work is natural, add follow-up tasks as they emerge. For task breakdown: aim for reasonably-scoped tasks, group related small actions into logical units, split tasks requiring different approaches.\n\nWhen uncertain whether to use task management, err on the side of creating tasks. Proactive organization demonstrates thoroughness and ensures comprehensive work completion.\n`;\n\nconst TaskProps = Schema.Struct({\n  id: Plan.TaskId,\n  title: Schema.String,\n  status: Schema.Literal('todo', 'in-progress', 'done'),\n});\n\nexport const UpdateTasks = Operation.make({\n  meta: {\n    key: 'org.dxos.function.planning.update-tasks',\n    name: 'Update tasks',\n    description: INSTRUCTIONS,\n  },\n  input: Schema.Struct({\n    tasks: Schema.Array(TaskProps),\n  }),\n  output: Schema.Any,\n  services: [AiContextService, Database.Service],\n});\n"],
+  "mappings": ";;;;;AAIA,YAAYA,YAAY;AAExB,SAASC,wBAAwB;AACjC,SAASC,gBAAgB;AACzB,SAASC,iBAAiB;AAC1B,SAASC,YAAY;AAIrB,IAAMC,eAAeC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0GrB,IAAMC,YAAmBC,cAAO;EAC9BC,IAAIC,aAAKC;EACTC,OAAcC;EACdC,QAAeC,eAAQ,QAAQ,eAAe,MAAA;AAChD,CAAA;AAEO,IAAMC,cAAcC,UAAUC,KAAK;EACxCC,MAAM;IACJC,KAAK;IACLC,MAAM;IACNC,aAAajB;EACf;EACAkB,OAAcf,cAAO;IACnBgB,OAAcC,aAAMlB,SAAAA;EACtB,CAAA;EACAmB,QAAeC;EACfC,UAAU;IAACC;IAAkBC,SAASC;;AACxC,CAAA;",
+  "names": ["Schema", "AiContextService", "Database", "Operation", "trim", "INSTRUCTIONS", "trim", "TaskProps", "Struct", "id", "Plan", "TaskId", "title", "String", "status", "Literal", "UpdateTasks", "Operation", "make", "meta", "key", "name", "description", "input", "tasks", "Array", "output", "Any", "services", "AiContextService", "Database", "Service"]
+}