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

package/dist/types/src/testing/data/exa-search-1748337331526.d.ts

@@ -1,37 +0,0 @@
-declare const _default: {
-    requestId: string;
-    autopromptString: string;
-    resolvedSearchType: string;
-    results: ({
-        id: string;
-        title: string;
-        url: string;
-        publishedDate: string;
-        author: string;
-        score: number;
-        text: string;
-        image: string;
-        favicon: string;
-    } | {
-        id: string;
-        title: string;
-        url: string;
-        publishedDate: string;
-        author: string;
-        text: string;
-        image: string;
-        favicon: string;
-        score?: undefined;
-    })[];
-    costDollars: {
-        total: number;
-        search: {
-            neural: number;
-        };
-        contents: {
-            text: number;
-        };
-    };
-};
-export default _default;
-//# sourceMappingURL=exa-search-1748337331526.d.ts.map

package/dist/types/src/testing/data/exa-search-1748337331526.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"exa-search-1748337331526.d.ts","sourceRoot":"","sources":["../../../../../src/testing/data/exa-search-1748337331526.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,wBA2IE"}

package/dist/types/src/testing/data/exa-search-1748337344119.d.ts

@@ -1,58 +0,0 @@
-declare const _default: {
-    requestId: string;
-    autopromptString: string;
-    autoDate: string;
-    resolvedSearchType: string;
-    results: ({
-        id: string;
-        title: string;
-        url: string;
-        publishedDate: string;
-        author: string;
-        score: number;
-        text: string;
-        favicon: string;
-        image?: undefined;
-    } | {
-        id: string;
-        title: string;
-        url: string;
-        publishedDate: string;
-        author: string;
-        score: number;
-        text: string;
-        favicon?: undefined;
-        image?: undefined;
-    } | {
-        id: string;
-        title: string;
-        url: string;
-        publishedDate: string;
-        author: string;
-        score: number;
-        text: string;
-        image: string;
-        favicon: string;
-    } | {
-        id: string;
-        title: string;
-        url: string;
-        author: string;
-        text: string;
-        image: string;
-        favicon: string;
-        publishedDate?: undefined;
-        score?: undefined;
-    })[];
-    costDollars: {
-        total: number;
-        search: {
-            neural: number;
-        };
-        contents: {
-            text: number;
-        };
-    };
-};
-export default _default;
-//# sourceMappingURL=exa-search-1748337344119.d.ts.map

package/dist/types/src/testing/data/exa-search-1748337344119.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"exa-search-1748337344119.d.ts","sourceRoot":"","sources":["../../../../../src/testing/data/exa-search-1748337344119.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,wBAgIE"}

package/dist/types/src/testing/data/index.d.ts

@@ -1,3 +0,0 @@
-import type { SearchResponse } from 'exa-js';
-export declare const SEARCH_RESULTS: SearchResponse<any>[];
-//# sourceMappingURL=index.d.ts.map

package/dist/types/src/testing/data/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/testing/data/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAM7C,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,GAAG,CAAC,EAAgC,CAAC"}

package/src/blueprints/design/design-blueprint.test.ts

@@ -1,108 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { describe, it } from '@effect/vitest';
-import * as Effect from 'effect/Effect';
-import * as Layer from 'effect/Layer';
-
-import { AiService, ConsolePrinter } from '@dxos/ai';
-import { AiServiceTestingPreset } from '@dxos/ai/testing';
-import {
-  AiConversation,
-  type ContextBinding,
-  GenerationObserver,
-  makeToolExecutionServiceFromFunctions,
-  makeToolResolverFromFunctions,
-} from '@dxos/assistant';
-import { Blueprint } from '@dxos/blueprints';
-import { Obj, Ref } from '@dxos/echo';
-import { TestHelpers, acquireReleaseResource } from '@dxos/effect';
-import {
-  ComputeEventLogger,
-  DatabaseService,
-  FunctionInvocationService,
-  QueueService,
-  TracingService,
-} from '@dxos/functions';
-import { TestDatabaseLayer } from '@dxos/functions/testing';
-import { log } from '@dxos/log';
-import { Markdown } from '@dxos/plugin-markdown/types';
-import { DataType } from '@dxos/schema';
-import { trim } from '@dxos/util';
-
-import { Document } from '../../functions';
-import { testToolkit } from '../testing';
-
-import blueprint from './design-blueprint';
-
-describe('Design Blueprint', { timeout: 120_000 }, () => {
-  it.scoped(
-    'design blueprint',
-    Effect.fn(
-      function* ({ expect }) {
-        const observer = GenerationObserver.fromPrinter(new ConsolePrinter());
-        const queue = yield* QueueService.createQueue<DataType.Message | ContextBinding>();
-        const conversation = yield* acquireReleaseResource(() => new AiConversation(queue));
-
-        yield* DatabaseService.add(blueprint);
-        yield* Effect.promise(() =>
-          conversation.context.bind({
-            blueprints: [Ref.make(blueprint)],
-          }),
-        );
-
-        const artifact = yield* DatabaseService.add(Markdown.makeDocument({ content: 'Hello, world!' }));
-        let prevContent = artifact.content;
-
-        {
-          const prompt = trim`
-            I want to design a new feature for our product. 
-
-            We need to add a user profile system with the following requirements:
-            1. Users should be able to create and edit their profiles
-            2. Profile should include basic info like name, bio, avatar
-            3. Users can control privacy settings for their profile
-            4. Profile should show user's activity history
-            5. Need to consider data storage and security implications
-
-            Let's capture the key design decisions in our spec in ${Obj.getDXN(artifact)}
-          `;
-
-          yield* conversation.createRequest({ prompt, observer });
-          log.info('spec', { doc: artifact });
-          expect(artifact.content).not.toBe(prevContent);
-          prevContent = artifact.content;
-        }
-
-        {
-          const prompt = trim`
-            I want this to be built on top of Durable Objects and SQLite database. 
-            Adjust the spec to reflect this.
-          `;
-
-          yield* conversation.createRequest({ observer, prompt });
-          expect(artifact.content).not.toBe(prevContent);
-          prevContent = artifact.content;
-        }
-      },
-      Effect.provide(
-        Layer.mergeAll(
-          makeToolResolverFromFunctions([Document.read, Document.update], testToolkit),
-          makeToolExecutionServiceFromFunctions(testToolkit, testToolkit.toLayer({}) as any),
-          AiService.model('@anthropic/claude-3-5-sonnet-20241022'),
-        ).pipe(
-          Layer.provideMerge(TestDatabaseLayer({ types: [DataType.Text, Markdown.Document, Blueprint.Blueprint] })),
-          Layer.provideMerge(AiServiceTestingPreset('direct')),
-          Layer.provideMerge(
-            FunctionInvocationService.layerTestMocked({ functions: [Document.read, Document.update] }).pipe(
-              Layer.provideMerge(ComputeEventLogger.layerFromTracing),
-              Layer.provideMerge(TracingService.layerNoop),
-            ),
-          ),
-        ),
-      ),
-      TestHelpers.taggedTest('llm'),
-    ),
-  );
-});

package/src/blueprints/design/design-blueprint.ts

@@ -1,33 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { ToolId } from '@dxos/ai';
-import { Blueprint } from '@dxos/blueprints';
-import { Obj, Ref } from '@dxos/echo';
-import { DataType } from '@dxos/schema';
-import { trim } from '@dxos/util';
-
-import { Document } from '../../functions';
-
-const instructions = trim`
-  You manage a design spec based on the conversation.
-  The design spec is a markdown document that is used to record the tasks.
-  The design spec document follows a hierarchical structure, with nested markdown bulleted sections.
-  Use the appropriate tools to read and write the design spec document.
-  Maintain the document so that it can convey all relevant points from the conversation.
-  When replying to the user, be terse with your comments about design doc handling.
-  Do not announce when you read or write the design spec document.
-`;
-
-const blueprint: Blueprint.Blueprint = Obj.make(Blueprint.Blueprint, {
-  key: 'dxos.org/blueprint/design',
-  name: 'Design Spec',
-  description: 'Preserve the conversation in the design spec.',
-  instructions: {
-    source: Ref.make(DataType.makeText(instructions)),
-  },
-  tools: [Document.read, Document.update].map((fn) => ToolId.make(fn.key)),
-});
-
-export default blueprint;

package/src/blueprints/design/index.ts

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import blueprint from './design-blueprint';
-
-export default blueprint;

package/src/blueprints/discord/discord-blueprint.ts

@@ -1,34 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { ToolId } from '@dxos/ai';
-import { Blueprint } from '@dxos/blueprints';
-import { Obj, Ref } from '@dxos/echo';
-import { DataType } from '@dxos/schema';
-import { trim } from '@dxos/util';
-
-import { Discord } from '../../functions';
-
-/**
- * Agent prompt instructions for managing hierarchical task lists.
- */
-const instructions = trim`
-  You are able to fetch messages from Discord servers.
-
-  Known servers:
-
-  DXOS serverId: 837138313172353095
-`;
-
-export const blueprint = Obj.make(Blueprint.Blueprint, {
-  key: 'dxos.org/blueprint/discord',
-  name: 'Discord',
-  description: 'Discord integration.',
-  instructions: {
-    source: Ref.make(DataType.makeText(instructions)),
-  },
-  tools: [ToolId.make(Discord.fetch.key)],
-});
-
-export default blueprint;

package/src/blueprints/linear/linear-blueprint.ts

@@ -1,35 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { ToolId } from '@dxos/ai';
-import { Blueprint } from '@dxos/blueprints';
-import { Obj, Ref } from '@dxos/echo';
-import { DataType } from '@dxos/schema';
-import { trim } from '@dxos/util';
-
-import { Linear } from '../../functions';
-
-/**
- * Agent prompt instructions for managing hierarchical task lists.
- */
-const instructions = trim`
-  You are able to sync Linear workspaces.
-  Sometimes sync does not complete in one go and you need to call the function again.
-
-  Known workspaces:
-
-  DXOS teamId: 1127c63a-6f77-4725-9229-50f6cd47321c
-`;
-
-export const blueprint = Obj.make(Blueprint.Blueprint, {
-  key: 'dxos.org/blueprint/linear',
-  name: 'Linear',
-  description: 'Syncs Linear workspaces.',
-  instructions: {
-    source: Ref.make(DataType.makeText(instructions)),
-  },
-  tools: [Linear.sync].map((tool) => ToolId.make(tool.key)),
-});
-
-export default blueprint;

package/src/blueprints/planning/planning-blueprint.test.ts

@@ -1,129 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { describe, it } from '@effect/vitest';
-import * as Effect from 'effect/Effect';
-import * as Layer from 'effect/Layer';
-
-import { AiService } from '@dxos/ai';
-import { AiServiceTestingPreset } from '@dxos/ai/testing';
-import {
-  AiConversation,
-  type ContextBinding,
-  makeToolExecutionServiceFromFunctions,
-  makeToolResolverFromFunctions,
-} from '@dxos/assistant';
-import { Blueprint } from '@dxos/blueprints';
-import { Obj, Ref } from '@dxos/echo';
-import { TestHelpers, acquireReleaseResource } from '@dxos/effect';
-import {
-  ComputeEventLogger,
-  DatabaseService,
-  FunctionImplementationResolver,
-  FunctionInvocationService,
-  QueueService,
-  TracingService,
-} from '@dxos/functions';
-import { TestDatabaseLayer } from '@dxos/functions/testing';
-import { log } from '@dxos/log';
-import { Markdown } from '@dxos/plugin-markdown/types';
-import { DataType } from '@dxos/schema';
-import { trim } from '@dxos/util';
-
-import { Tasks } from '../../functions';
-import { type TestStep, runSteps, testToolkit } from '../testing';
-
-import blueprint from './planning-blueprint';
-
-describe('Planning Blueprint', { timeout: 120_000 }, () => {
-  it.scoped(
-    'planning blueprint',
-    Effect.fn(
-      function* ({ expect }) {
-        const queue = yield* QueueService.createQueue<DataType.Message | ContextBinding>();
-        const conversation = yield* acquireReleaseResource(() => new AiConversation(queue));
-
-        yield* DatabaseService.add(blueprint);
-        yield* Effect.promise(() =>
-          conversation.context.bind({
-            blueprints: [Ref.make(blueprint)],
-          }),
-        );
-
-        const artifact = yield* DatabaseService.add(Markdown.makeDocument());
-        let prevContent = artifact.content;
-        const matchList =
-          ({ includes = [], excludes = [] }: { includes: RegExp[]; excludes?: RegExp[] }) =>
-          async () => {
-            const { content } = await artifact.content.load();
-            log.info('spec', { doc: artifact.content.target?.content });
-            expect(content).not.toBe(prevContent);
-            const text = content.toLowerCase();
-            for (const include of includes) {
-              expect(text.match(include), `does not include: ${include}`).toBeTruthy();
-            }
-            for (const exclude of excludes) {
-              expect(text.match(exclude), `includes: ${exclude}`).toBeFalsy();
-            }
-            prevContent = artifact.content;
-          };
-
-        const system = 'You are a helpful assistant.';
-        const steps: TestStep[] = [
-          {
-            system,
-            prompt: trim`
-              I'm building a shelf.
-              Maintain a shopping list here: ${Obj.getDXN(artifact)}
-              I need a hammer, nails, and a saw.
-            `,
-            test: matchList({
-              includes: [/- \[.+hammer/, /- \[.+nails/, /- \[.+saw/],
-            }),
-          },
-          {
-            system,
-            prompt: trim`
-              I will need a board too.
-            `,
-            test: matchList({
-              includes: [/- \[.+board/],
-            }),
-          },
-          {
-            system,
-            prompt: trim`
-              Actually I'm going to use screws and a screwdriver.
-            `,
-            test: matchList({
-              includes: [/- \[.+screwdriver/, /- \[.+screws/],
-              excludes: [/- \[.+hammer/, /- \[.+nails/],
-            }),
-          },
-        ];
-
-        yield* runSteps(conversation, steps);
-      },
-      Effect.provide(
-        Layer.mergeAll(
-          TestDatabaseLayer({ types: [DataType.Text, Markdown.Document, Blueprint.Blueprint] }),
-          makeToolResolverFromFunctions([Tasks.read, Tasks.update], testToolkit),
-          makeToolExecutionServiceFromFunctions(testToolkit, testToolkit.toLayer({}) as any),
-          AiService.model('@anthropic/claude-3-5-sonnet-20241022'),
-        ).pipe(
-          Layer.provideMerge(
-            FunctionInvocationService.layerTestMocked({ functions: [Tasks.read, Tasks.update] }).pipe(
-              Layer.provideMerge(ComputeEventLogger.layerFromTracing),
-              Layer.provideMerge(TracingService.layerNoop),
-            ),
-          ),
-          Layer.provideMerge(FunctionImplementationResolver.layerTest({ functions: [Tasks.read, Tasks.update] })),
-          Layer.provideMerge(TestDatabaseLayer({ types: [DataType.Text, Markdown.Document, Blueprint.Blueprint] })),
-          Layer.provideMerge(AiServiceTestingPreset('direct')),
-        ),
-      ),
-      TestHelpers.taggedTest('llm'),
-    ),
-  );
-});

package/src/blueprints/planning/planning-blueprint.ts

@@ -1,98 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { ToolId } from '@dxos/ai';
-import { Blueprint } from '@dxos/blueprints';
-import { Obj, Ref } from '@dxos/echo';
-import { DataType } from '@dxos/schema';
-import { trim } from '@dxos/util';
-
-import { Tasks } from '../../functions';
-
-/**
- * Agent prompt instructions for managing hierarchical task lists.
- */
-const instructions = trim`
-  You are a task management agent that maintains hierarchical task lists where each line is a task.
-
-  ## Document Format
-  You will receive task lists with line numbers prefixed like:
-  
-  ${'```'}
-  1. - [ ] First main task
-  2.   - [ ] Subtask 1: Research phase
-  3.     - [x] Literature review
-  4.     - [ ] Stakeholder interviews
-  5.   - [ ] Subtask 2: Implementation
-  6.     - [ ] Setup infrastructure
-  7.     - [ ] Write core functionality
-  8. - [ ] Another main task
-  ${'```'}
-
-  ## Task Hierarchy
-  - 0 spaces: Top-level tasks
-  - 2 spaces: First-level subtasks
-  - 4 spaces: Second-level subtasks
-  - 6 spaces: Third-level subtasks (and so on)
-
-  ## Available Operations
-  You can modify the task list using these operations:
-
-  1. **insertTask(lineNumber, text, completed?, indent?)** - Insert a new task
-  2. **deleteTask(lineNumber)** - Delete a task
-  3. **updateTaskText(lineNumber, text)** - Change task description
-  4. **toggleTaskCompletion(lineNumber, completed?)** - Mark task complete/incomplete
-  5. **setTaskIndent(lineNumber, indent)** - Change task hierarchy level
-
-  ## Examples
-
-  ### Example 1: Adding a subtask
-  **User:** "Add a subtask 'Code review' under the task on line 1"
-  **Response:** \`insertTask(2, "Code review", false, 2)\`
-
-  ### Example 2: Marking a task complete
-  **User:** "Mark the task on line 3 as complete"
-  **Response:** \`toggleTaskCompletion(3, true)\`
-
-  ### Example 3: Updating task text
-  **User:** "Change the task on line 5 to 'Backend implementation'"
-  **Response:** \`updateTaskText(5, "Backend implementation")\`
-
-  ### Example 4: Creating a task hierarchy
-  **User:** "Add a main task 'Testing phase' with two subtasks"
-  **Response:**
-  \`\`\`
-  insertTask(999, "Testing phase", false, 0)
-  insertTask(999, "Unit tests", false, 2)
-  insertTask(999, "Integration tests", false, 2)
-  \`\`\`
-
-  ### Example 5: Reorganizing hierarchy
-  **User:** "Move the task on line 4 to be a main task (top level)"
-  **Response:** \`setTaskIndent(4, 0)\`
-
-  ### Example 6: Adding nested subtasks
-  **User:** "Add a sub-subtask 'Write test cases' under line 6"
-  **Response:** \`insertTask(7, "Write test cases", false, 4)\`
-
-  ## Guidelines
-  - Always reference line numbers from the numbered document you receive
-  - Use line number 999 to append to the end of the document
-  - Maintain logical hierarchy (subtasks should be indented under their parent)
-  - Use appropriate indentation levels (0, 2, 4, 6, etc. spaces)
-  - When creating subtasks, consider the parent task's completion status
-  - Be precise with task descriptions and hierarchy levels
-`;
-
-export const blueprint: Blueprint.Blueprint = Obj.make(Blueprint.Blueprint, {
-  key: 'dxos.org/blueprint/planning',
-  name: 'Planning',
-  description: 'Plans and tracks complex tasks with artifact management.',
-  instructions: {
-    source: Ref.make(DataType.makeText(instructions)),
-  },
-  tools: [Tasks.read, Tasks.update].map((fn) => ToolId.make(fn.key)),
-});
-
-export default blueprint;

package/src/blueprints/research/index.ts

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import blueprint from './research-blueprint';
-
-export default blueprint;

package/src/blueprints/research/research-blueprint.test.ts

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { describe } from '@effect/vitest';
-
-describe.runIf(process.env.DX_RUN_SLOW_TESTS === '1')('Research Blueprint', { timeout: 120_000 }, () => {});

package/src/blueprints/research/research-blueprint.ts

@@ -1,45 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { ToolId } from '@dxos/ai';
-import { Blueprint } from '@dxos/blueprints';
-import { Obj, Ref } from '@dxos/echo';
-import { DataType } from '@dxos/schema';
-import { trim } from '@dxos/util';
-
-import { Research } from '../../functions';
-
-/**
- * Agent prompt instructions for managing hierarchical task lists.
- */
-const instructions = trim`
-  {{! Research }}
-
-  You are an analyst that does research tasks using tools that scrape the web and create structured data.
-  The result of the research is a set of structured entities forming an interconnected graph.
-  When you are done, reply with the created objects.
-  Do not print the data, instead reply with inline references to the created objects.
-  Those will be later substituted with the pills representing the created objects.
-  Print the rest of the created objects as block references after the main note.
-
-  <example>
-    Based on my research, Google was founded by @dxn:queue:data:B6INSIBY3CBEF4M5VZRYBCMAHQMPYK5AJ:01K24XMVHSZHS97SG1VTVQDM5Z:01K24XPK464FSCKVQJAB2H662M and @dxn:queue:data:B6INSIBY3CBEF4M5VZRYBCMAHQMPYK5AJ:01K24XMVHSZHS97SG1VTVQDM5Z:01K24XPK46K31DDW62PBW9H2ZQ
-
-    <object><dxn>dxn:queue:data:B6INSIBY3CBEF4M5VZRYBCMAHQMPYK5AJ:01K24XMVHSZHS97SG1VTVQDM5Z:01K24XPK464FSCKVQJAB2H662M</dxn></object>
-    <object><dxn>dxn:queue:data:B6INSIBY3CBEF4M5VZRYBCMAHQMPYK5AJ:01K24XMVHSZHS97SG1VTVQDM5Z:01K24XPK46K31DDW62PBW9H2ZQ</dxn></object>
-    <object><dxn>dxn:queue:data:B6INSIBY3CBEF4M5VZRYBCMAHQMPYK5AJ:01K24XMVHSZHS97SG1VTVQDM5Z:01K24XPK46K31DDW62PBW92333</dxn></object>
-  </example>
-`;
-
-export const blueprint: Blueprint.Blueprint = Obj.make(Blueprint.Blueprint, {
-  key: 'dxos.org/blueprint/research',
-  name: 'Research',
-  description: 'Researches the web and creates structured data.',
-  instructions: {
-    source: Ref.make(DataType.makeText(instructions)),
-  },
-  tools: [Research.create, Research.research].map((fn) => ToolId.make(fn.key)),
-});
-
-export default blueprint;

package/src/blueprints/websearch/websearch-blueprint.ts

@@ -1,20 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { ToolId } from '@dxos/ai';
-import { Blueprint } from '@dxos/blueprints';
-import { Obj, Ref } from '@dxos/echo';
-import { DataType } from '@dxos/schema';
-
-const blueprint: Blueprint.Blueprint = Obj.make(Blueprint.Blueprint, {
-  key: 'dxos.org/blueprint/web-search',
-  name: 'Web Search',
-  description: 'Search the web.',
-  instructions: {
-    source: Ref.make(DataType.makeText('')), // No instructions required.
-  },
-  tools: [ToolId.make('AnthropicWebSearch')],
-});
-
-export default blueprint;