@dxos/assistant-toolkit 0.8.4-main.21d9917

package/src/functions/agent/prompt.ts

@@ -0,0 +1,118 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Array from 'effect/Array';
+import * as Effect from 'effect/Effect';
+import * as Function from 'effect/Function';
+import * as Match from 'effect/Match';
+import * as Option from 'effect/Option';
+import * as Schema from 'effect/Schema';
+
+import { AiService, ConsolePrinter, ModelName } from '@dxos/ai';
+import { AiSession, GenerationObserver, createToolkit } from '@dxos/assistant';
+import { Prompt, Template } from '@dxos/blueprints';
+import { Obj, Ref, Type } from '@dxos/echo';
+import { Database } from '@dxos/echo';
+import { TracingService, defineFunction } from '@dxos/functions';
+import { log } from '@dxos/log';
+
+const DEFAULT_MODEL: ModelName = '@anthropic/claude-opus-4-0';
+
+export default defineFunction({
+  key: 'dxos.org/function/prompt',
+  name: 'Agent',
+  description: 'Agentic worker that executes a provided prompt using blueprints and tools.',
+  inputSchema: Schema.Struct({
+    prompt: Type.Ref(Prompt.Prompt),
+    systemPrompt: Type.Ref(Prompt.Prompt).pipe(Schema.optional),
+    /**
+     * @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' })),
+  }),
+  outputSchema: Schema.Any,
+  handler: Effect.fnUntraced(function* ({ data }) {
+    log.info('processing input', { input: data.input });
+
+    // TODO(wittjosiah): Support templated object as input.
+    //   Currently the object templating only supports direct pass-through or strings.
+    // const input = { ...data.input };
+    // for (const key of Object.keys(data.input)) {
+    //   const value = data.input[key];
+    //   if (Ref.isRef(value)) {
+    //     const object = yield* Database.Service.load(value);
+    //     input[key] = Obj.toJSON(object);
+    //   } else {
+    //     input[key] = JSON.stringify(value);
+    //   }
+    // }
+    const input = yield* Match.value(data.input).pipe(
+      Match.when(
+        (value: any) => Ref.isRef(value),
+        Effect.fnUntraced(function* (ref) {
+          const object = yield* Database.Service.load(ref);
+          return Obj.toJSON(object as Obj.Unknown);
+        }),
+      ),
+      Match.orElse(() => Effect.succeed(data.input)),
+    );
+
+    yield* Database.Service.flush({ indexes: true });
+    const prompt = yield* Database.Service.load(data.prompt);
+    const systemPrompt = data.systemPrompt ? yield* Database.Service.load(data.systemPrompt) : undefined;
+    yield* TracingService.emitStatus({ message: `Running ${prompt.id}` });
+
+    log.info('starting agent', { prompt: prompt.id, input });
+
+    const blueprints = yield* Function.pipe(
+      prompt.blueprints,
+      Array.appendAll(systemPrompt?.blueprints ?? []),
+      Effect.forEach(Database.Service.loadOption),
+      Effect.map(Array.filter(Option.isSome)),
+      Effect.map(Array.map((option) => option.value)),
+    );
+    const toolkit = yield* createToolkit({ blueprints });
+
+    const objects = yield* Function.pipe(
+      prompt.context,
+      Array.appendAll(systemPrompt?.context ?? []),
+      Effect.forEach(Database.Service.loadOption),
+      Effect.map(Array.filter(Option.isSome)),
+      Effect.map(Array.map((option) => option.value)),
+    );
+
+    const promptInstructions = yield* Database.Service.load(prompt.instructions.source);
+    const promptText = Template.process(promptInstructions.content, input);
+
+    const systemInstructions = systemPrompt
+      ? yield* Database.Service.load(systemPrompt.instructions.source)
+      : undefined;
+    const systemText = systemInstructions ? Template.process(systemInstructions.content, {}) : undefined;
+
+    const session = new AiSession();
+    const result = yield* session
+      .run({
+        prompt: promptText,
+        system: systemText,
+        blueprints,
+        objects: objects as Obj.Unknown[],
+        toolkit,
+        observer: GenerationObserver.fromPrinter(new ConsolePrinter({ tag: 'agent' })),
+      })
+      .pipe(Effect.provide(AiService.model(data.model ?? DEFAULT_MODEL)));
+    const lastBlock = result
+      .at(-1)
+      ?.blocks.filter((block) => block._tag === 'text')
+      .at(-1);
+
+    return {
+      note: lastBlock?.text,
+    };
+  }),
+});

package/src/functions/discord/fetch-messages.test.ts

@@ -0,0 +1,58 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Toolkit from '@effect/ai/Toolkit';
+import * as FetchHttpClient from '@effect/platform/FetchHttpClient';
+import { describe, it } from '@effect/vitest';
+import * as Config from 'effect/Config';
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+
+import { AiService } from '@dxos/ai';
+import { AiServiceTestingPreset } from '@dxos/ai/testing';
+import { makeToolExecutionServiceFromFunctions, makeToolResolverFromFunctions } from '@dxos/assistant';
+import { TestHelpers } from '@dxos/effect/testing';
+import { CredentialsService, FunctionInvocationService, TracingService } from '@dxos/functions';
+import { FunctionInvocationServiceLayerTestMocked, TestDatabaseLayer } from '@dxos/functions-runtime/testing';
+
+import { default as fetchMessages } from './fetch-messages';
+
+const TestLayer = Layer.mergeAll(
+  AiService.model('@anthropic/claude-opus-4-0'),
+  makeToolResolverFromFunctions([], Toolkit.make()),
+  makeToolExecutionServiceFromFunctions(Toolkit.make() as any, Layer.empty as any),
+).pipe(
+  Layer.provideMerge(
+    Layer.mergeAll(
+      AiServiceTestingPreset('direct'),
+      TestDatabaseLayer({}),
+      CredentialsService.layerConfig([{ service: 'discord.com', apiKey: Config.redacted('DISCORD_TOKEN') }]),
+      FetchHttpClient.layer,
+      FunctionInvocationServiceLayerTestMocked({ functions: [fetchMessages] }).pipe(
+        Layer.provideMerge(TracingService.layerNoop),
+      ),
+    ),
+  ),
+);
+
+const DXOS_SERVER_ID = '837138313172353095';
+
+describe('Feed', { timeout: 600_000 }, () => {
+  it.effect(
+    'fetch discord messages',
+    Effect.fnUntraced(
+      function* (_) {
+        const messages = yield* FunctionInvocationService.invokeFunction(fetchMessages, {
+          serverId: DXOS_SERVER_ID,
+          // channelId: '1404487604761526423',
+          last: '7d',
+        });
+        console.log(messages);
+      },
+      Effect.provide(TestLayer),
+      TestHelpers.provideTestContext,
+      TestHelpers.taggedTest('sync'),
+    ),
+  );
+});

package/src/functions/discord/fetch-messages.ts

@@ -0,0 +1,252 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as FetchHttpClient from '@effect/platform/FetchHttpClient';
+import { DiscordConfig, DiscordREST, DiscordRESTMemoryLive } from 'dfx';
+import type {
+  GuildChannelResponse,
+  MessageResponse,
+  PrivateChannelResponse,
+  PrivateGroupChannelResponse,
+  ThreadResponse,
+} from 'dfx/types';
+import * as Array from 'effect/Array';
+import * as Effect from 'effect/Effect';
+import * as Function from 'effect/Function';
+import * as Layer from 'effect/Layer';
+import * as Option from 'effect/Option';
+import * as Schema from 'effect/Schema';
+
+import { Obj } from '@dxos/echo';
+import { CredentialsService, TracingService, defineFunction } from '@dxos/functions';
+import { log } from '@dxos/log';
+import { Message } from '@dxos/types';
+
+// TODO(dmaretskyi): Extract.
+const TimeRange = class extends Schema.String.pipe(Schema.pattern(/\d+(s|m|h|d)/)).annotations({
+  description: 'Time range. 1d - 1 day, 2h - 2 hours, 30m - 30 minutes, 15s - 15 seconds.',
+  examples: ['1d', '2h', '30m', '15s'],
+}) {
+  static toSeconds(timeRange: Schema.Schema.Type<typeof TimeRange>) {
+    const match = timeRange.match(/(\d+)(s|m|h|d)/);
+    if (!match) {
+      throw new Error(`Invalid time range: ${timeRange}`);
+    }
+    const [_, amount, unit] = match;
+    switch (unit) {
+      case 's':
+        return Number(amount);
+      case 'm':
+        return Number(amount) * 60;
+      case 'h':
+        return Number(amount) * 60 * 60;
+      case 'd':
+        return Number(amount) * 24 * 60 * 60;
+      default:
+        throw new Error(`Invalid time range unit: ${unit}`);
+    }
+  }
+};
+type TimeRange = Schema.Schema.Type<typeof TimeRange>;
+
+const DiscordConfigFromCredential = Layer.unwrapEffect(
+  Effect.gen(function* () {
+    return DiscordConfig.layer({
+      token: yield* CredentialsService.getApiKey({ service: 'discord.com' }),
+      rest: {
+        baseUrl: 'https://api-proxy.dxos.workers.dev/discord.com/api/v10',
+      },
+    });
+  }),
+);
+
+type DiscordChannel = GuildChannelResponse | PrivateChannelResponse | PrivateGroupChannelResponse | ThreadResponse;
+
+const DEFAULT_AFTER = 1704067200; // 2024-01-01
+const DEFAULT_LIMIT = 500;
+const DEFAULT_IGNORE_USERNAMES = ['GitHub', 'Needle'];
+
+// TODO(dmaretskyi): Align with standard thread type.
+type Thread = {
+  discordChannelId: string;
+  name?: string;
+  messages: Message.Message[];
+};
+
+export default defineFunction({
+  key: 'dxos.org/function/fetch-discord-messages',
+  name: 'Sync Discord messages',
+  inputSchema: Schema.Struct({
+    serverId: Schema.String.annotations({
+      description: 'The ID of the server to fetch messages from.',
+    }),
+    channelId: Schema.optional(Schema.String).annotations({
+      description:
+        'The ID of the channel to fetch messages from. Will crawl all channels from the server if not specified.',
+    }),
+    after: Schema.optional(Schema.Number).annotations({
+      description:
+        'Fetch messages that were sent after a given date. Unix timestamp in seconds. Exclusive with `last`.',
+    }),
+    last: TimeRange.annotations({
+      description:
+        'Time range to fetch most recent messages. Specifies the range in the past, from now. "1d" would fetch messages from the last 24 hours.',
+    }),
+    limit: Schema.optional(Schema.Number).annotations({
+      description: 'The maximum number of messages to fetch.',
+    }),
+    pageSize: Schema.optional(Schema.Number).annotations({
+      description: 'The number of messages to fetch per page.',
+    }),
+    ignoreUsernames: Schema.optional(Schema.Array(Schema.String)).annotations({
+      description: 'Exclude messages from these usernames.',
+    }),
+  }),
+  handler: Effect.fnUntraced(
+    function* ({
+      data: {
+        serverId,
+        channelId,
+        after,
+        last,
+        pageSize = 100,
+        limit = DEFAULT_LIMIT,
+        ignoreUsernames = DEFAULT_IGNORE_USERNAMES,
+      },
+    }) {
+      if (!after && !last) {
+        throw new Error('cannot specify both `after` and `last`');
+      }
+      const afterTs = last ? Date.now() / 1000 - TimeRange.toSeconds(last) : (after ?? DEFAULT_AFTER);
+
+      const rest = yield* DiscordREST;
+
+      let channels: DiscordChannel[] = [];
+      channels.push(...(yield* rest.listGuildChannels(serverId)));
+      const { threads: guildThreads } = yield* rest.getActiveGuildThreads(serverId);
+      channels.push(...guildThreads);
+      if (channelId) {
+        channels = channels.filter((channel) => channel.id === channelId);
+      }
+      if (channels.length === 0) {
+        throw new Error('no channels found');
+      }
+      for (const channel of channels) {
+        log.info('channel', { id: channel.id, name: 'name' in channel ? channel.name : undefined });
+      }
+
+      yield* TracingService.emitStatus({ message: `Will fetch from channels: ${channels.length}` });
+
+      const threads = yield* Effect.forEach(
+        channels,
+        Effect.fnUntraced(function* (channel) {
+          const allMessages: Message.Message[] = [];
+
+          let lastMessage: Option.Option<Message.Message> = Option.none();
+          while (true) {
+            const { id: lastId = undefined } = Function.pipe(
+              lastMessage,
+              Option.map(Obj.getKeys('discord.com')),
+              Option.flatMap(Option.fromIterable),
+              Option.getOrElse(() => ({ id: undefined })),
+            );
+
+            const options = {
+              after: !lastId ? `${generateSnowflake(afterTs)}` : lastId,
+              limit: pageSize,
+            };
+            log.info('fetching messages', {
+              lastId,
+              afterTs,
+              afterSnowflake: options.after,
+              after: parseSnowflake(options.after),
+              limit: options.limit,
+            });
+            const messages = yield* rest.listMessages(channel.id, options).pipe(
+              Effect.map(Array.map(makeMessage)),
+              Effect.map(Array.reverse),
+              Effect.catchTag('ErrorResponse', (err) =>
+                err.cause.code === 50001 ? Effect.succeed([]) : Effect.fail(err),
+              ),
+            );
+            if (messages.length > 0) {
+              lastMessage = Option.fromNullable(messages.at(-1));
+              allMessages.push(...messages);
+            } else {
+              break;
+            }
+            yield* TracingService.emitStatus({ message: `Fetched messages: ${allMessages.length}` });
+            if (allMessages.length >= limit) {
+              break;
+            }
+          }
+
+          return {
+            discordChannelId: channel.id,
+            name: 'name' in channel ? (channel.name ?? undefined) : undefined,
+            messages: allMessages
+              .filter((message) => !message.sender.name || !ignoreUsernames.includes(message.sender.name))
+              .filter((message) =>
+                message.blocks.some((block: any) => block._tag === 'text' && block.text.trim().length > 0),
+              ),
+          } satisfies Thread;
+        }),
+        { concurrency: 10 },
+      );
+
+      return threads
+        .filter((thread) => thread.messages.length > 0)
+        .map(serializeThread)
+        .join('\n');
+    },
+    Effect.provide(
+      DiscordRESTMemoryLive.pipe(Layer.provideMerge(DiscordConfigFromCredential)).pipe(
+        Layer.provide(FetchHttpClient.layer),
+      ),
+    ),
+    Effect.orDie,
+  ),
+});
+
+/**
+ * @param unixTimestamp in seconds
+ */
+const generateSnowflake = (unixTimestamp: number): bigint => {
+  const discordEpoch = 1420070400000n; // Discord Epoch (ms)
+  return (BigInt(unixTimestamp * 1000) - discordEpoch) << 22n;
+};
+
+const parseSnowflake = (snowflake: string): Date => {
+  const discordEpoch = 1420070400000n; // Discord Epoch (ms)
+  return new Date(Number((BigInt(snowflake) >> 22n) + discordEpoch));
+};
+
+// TODO(burdon): Move to @dxos/types.
+const makeMessage = (message: MessageResponse): Message.Message =>
+  Obj.make(Message.Message, {
+    [Obj.Meta]: {
+      keys: [
+        { id: message.id, source: 'discord.com' },
+        { id: message.channel_id, source: 'discord.com/thread' },
+      ],
+    },
+    sender: { name: message.author.username },
+    created: message.timestamp,
+    blocks: [{ _tag: 'text', text: message.content }],
+  });
+
+/**
+ * Standard JSON serialization is to verbose for large amounts of data.
+ */
+const serializeThread = (thread: Thread): string => {
+  return `<thread id=${thread.discordChannelId} name=${thread.name ?? ''}>\n${thread.messages
+    .map(
+      (message) =>
+        `  ${message.sender.name}: ${message.blocks
+          .filter((block: any) => block._tag === 'text')
+          .map((block: any) => block.text)
+          .join(' ')}`,
+    )
+    .join('\n')}\n</thread>`;
+};

package/src/functions/discord/index.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { default as fetch$ } from './fetch-messages';
+
+export namespace Discord {
+  export const fetch = fetch$;
+}

package/src/functions/document/index.ts

@@ -0,0 +1,12 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { default as read$ } from './read';
+import { default as update$ } from './update';
+
+/** @deprecated */
+export namespace Document {
+  export const read = read$;
+  export const update = update$;
+}

package/src/functions/document/read.ts

@@ -0,0 +1,30 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+import * as Schema from 'effect/Schema';
+
+import { ArtifactId } from '@dxos/assistant';
+import { Database } from '@dxos/echo';
+import { defineFunction } from '@dxos/functions';
+import { Markdown } from '@dxos/plugin-markdown/types';
+
+export default defineFunction({
+  key: 'dxos.org/function/markdown/read',
+  name: 'Read markdown document',
+  description: 'Read markdown document.',
+  inputSchema: Schema.Struct({
+    id: ArtifactId.annotations({
+      description: 'The ID of the document to read.',
+    }),
+  }),
+  outputSchema: Schema.Struct({
+    content: Schema.String,
+  }),
+  handler: Effect.fn(function* ({ data: { id } }) {
+    const doc = yield* Database.Service.resolve(ArtifactId.toDXN(id), Markdown.Document);
+    const { content } = yield* Database.Service.load(doc.content);
+    return { content };
+  }),
+});

package/src/functions/document/update.ts

@@ -0,0 +1,33 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+import * as Schema from 'effect/Schema';
+
+import { ArtifactId } from '@dxos/assistant';
+import { Database, Obj } from '@dxos/echo';
+import { defineFunction } from '@dxos/functions';
+import { Markdown } from '@dxos/plugin-markdown/types';
+
+export default defineFunction({
+  key: 'dxos.org/function/markdown/update',
+  name: 'Update markdown',
+  description: 'Updates the entire contents of the markdown document.',
+  inputSchema: Schema.Struct({
+    id: ArtifactId.annotations({
+      description: 'The ID of the document to write.',
+    }),
+    content: Schema.String.annotations({
+      description: 'New content to write to the document.',
+    }),
+  }),
+  outputSchema: Schema.Void,
+  handler: Effect.fn(function* ({ data: { id, content } }) {
+    const doc = yield* Database.Service.resolve(ArtifactId.toDXN(id), Markdown.Document);
+    const text = yield* Database.Service.load(doc.content);
+    Obj.change(text, (t) => {
+      t.content = content;
+    });
+  }),
+});