@dxos/assistant-toolkit 0.8.4-main.c85a9c8dae → 0.8.4-main.dfabb4ec29

package/src/blueprints/planning-old/functions/task-list.ts

@@ -1,165 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-/**
- * Hierarchical Task List Manager.
- *
- * A framework for managing hierarchical task lists where each line is a task.
- * Designed to work with language model agents that receive documents with line numbers.
- */
-export class MarkdownTasks {
-  private _lineEndings: string;
-  private _content: string[];
-
-  constructor(initialContent: string = '') {
-    // Detect line endings.
-    this._lineEndings = initialContent.includes('\r\n') ? '\r\n' : '\n';
-    this._content = initialContent ? initialContent.split(this._lineEndings) : [];
-  }
-
-  /**
-   * Get the current document content with line numbers prefixed.
-   */
-  getNumberedContent(): string {
-    return this._content
-      .map((line, index) => `${(index + 1).toString().padStart(3, ' ')}→${line}`)
-      .join(this._lineEndings);
-  }
-
-  /**
-   * Get the raw document content without line numbers.
-   */
-  getRawContent(): string {
-    return this._content.join(this._lineEndings);
-  }
-
-  /**
-   * Insert a new task at the specified line number (1-based).
-   * Indentation level determines hierarchy (0, 2, 4, 6 spaces etc.)
-   */
-  insertTask(lineNumber: number, taskText: string, completed: boolean = false, indent: number = 0): void {
-    const indentStr = ' '.repeat(indent);
-    const taskLine = completed ? `${indentStr}- [x] ${taskText}` : `${indentStr}- [ ] ${taskText}`;
-    const insertIndex = Math.max(0, Math.min(lineNumber - 1, this._content.length));
-    this._content.splice(insertIndex, 0, taskLine);
-  }
-
-  /**
-   * Delete a task at the specified line number (1-based).
-   */
-  deleteTask(lineNumber: number): boolean {
-    if (lineNumber < 1 || lineNumber > this._content.length) {
-      return false;
-    }
-    this._content.splice(lineNumber - 1, 1);
-    return true;
-  }
-
-  /**
-   * Update the text of a task at the specified line number (1-based).
-   */
-  updateTaskText(lineNumber: number, newText: string): boolean {
-    if (lineNumber < 1 || lineNumber > this._content.length) {
-      return false;
-    }
-
-    const currentLine = this._content[lineNumber - 1];
-    const taskMatch = currentLine.match(/^(\s*- \[[x ]\] )(.*)$/);
-
-    if (taskMatch) {
-      this._content[lineNumber - 1] = `${taskMatch[1]}${newText}`;
-      return true;
-    }
-    return false;
-  }
-
-  /**
-   * Mark a task as complete or incomplete at the specified line number (1-based).
-   */
-  toggleTaskCompletion(lineNumber: number, completed?: boolean): boolean {
-    if (lineNumber < 1 || lineNumber > this._content.length) {
-      return false;
-    }
-
-    const currentLine = this._content[lineNumber - 1];
-    const taskMatch = currentLine.match(/^(\s*- \[)([x ])(.*)$/);
-    if (taskMatch) {
-      const isCurrentlyComplete = taskMatch[2] === 'x';
-      const newStatus = completed !== undefined ? completed : !isCurrentlyComplete;
-      const statusChar = newStatus ? 'x' : ' ';
-      this._content[lineNumber - 1] = `${taskMatch[1]}${statusChar}${taskMatch[3]}`;
-      return true;
-    }
-
-    return false;
-  }
-
-  /**
-   * Change the indentation level of a task (for hierarchy).
-   */
-  setTaskIndent(lineNumber: number, indent: number): boolean {
-    if (lineNumber < 1 || lineNumber > this._content.length) {
-      return false;
-    }
-
-    const currentLine = this._content[lineNumber - 1];
-    const taskMatch = currentLine.match(/^\s*- (\[[x ]\] .*)$/);
-    if (taskMatch) {
-      const indentStr = ' '.repeat(indent);
-      this._content[lineNumber - 1] = `${indentStr}- ${taskMatch[1]}`;
-      return true;
-    }
-
-    return false;
-  }
-
-  /**
-   * Get the total number of lines in the document.
-   */
-  getLineCount(): number {
-    return this._content.length;
-  }
-
-  /**
-   * Apply multiple operations atomically.
-   */
-  applyOperations(operations: TaskOperation[]): void {
-    // Sort operations by line number in descending order to avoid index shifts.
-    const sortedOps = [...operations].sort((a, b) => {
-      const aLine = 'lineNumber' in a ? a.lineNumber : 0;
-      const bLine = 'lineNumber' in b ? b.lineNumber : 0;
-      return bLine - aLine;
-    });
-
-    for (const op of sortedOps) {
-      switch (op.type) {
-        case 'insertTask':
-          this.insertTask(op.lineNumber, op.text, op.completed, op.indent);
-          break;
-        case 'deleteTask':
-          this.deleteTask(op.lineNumber);
-          break;
-        case 'updateTaskText':
-          this.updateTaskText(op.lineNumber, op.text);
-          break;
-        case 'toggleTaskCompletion':
-          this.toggleTaskCompletion(op.lineNumber, op.completed);
-          break;
-        case 'setTaskIndent':
-          this.setTaskIndent(op.lineNumber, op.indent);
-          break;
-      }
-    }
-  }
-}
-
-/**
- * Operation types for batch task updates.
- */
-export type TaskOperation =
-  | { type: 'insertTask'; lineNumber: number; text: string; completed?: boolean; indent?: number }
-  | { type: 'deleteTask'; lineNumber: number }
-  | { type: 'updateTaskText'; lineNumber: number; text: string }
-  | { type: 'toggleTaskCompletion'; lineNumber: number; completed?: boolean }
-  | { type: 'setTaskIndent'; lineNumber: number; indent: number };

package/src/blueprints/planning-old/functions/update.ts

@@ -1,52 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Effect from 'effect/Effect';
-import * as Schema from 'effect/Schema';
-
-import { Database, Ref } from '@dxos/echo';
-import { defineFunction } from '@dxos/functions';
-import { Markdown } from '@dxos/plugin-markdown/types';
-
-import { MarkdownTasks, type TaskOperation } from './task-list';
-
-export default defineFunction({
-  key: 'dxos.org/function/markdown/update-tasks',
-  name: 'Update markdown',
-  description: 'Creates and updates tasks in markdown documents.',
-  inputSchema: Schema.Struct({
-    doc: Ref.Ref(Markdown.Document).annotations({
-      description: 'The ID of the document to update.',
-    }),
-    operations: Schema.optional(
-      Schema.Array(
-        Schema.Any.annotations({
-          description: 'Task operations to apply.',
-        }),
-      ),
-    ),
-  }),
-  outputSchema: Schema.Struct({
-    content: Schema.String,
-    numberedContent: Schema.String.annotations({
-      description: 'Content with line numbers for agent reference.',
-    }),
-  }),
-  handler: Effect.fn(function* ({ data: { doc, operations = [] } }) {
-    const document = yield* Database.load(doc);
-
-    // Create task manager and apply operations if provided.
-    const { content } = yield* Database.load(document.content);
-    const taskManager = new MarkdownTasks(content);
-    if (operations.length > 0) {
-      taskManager.applyOperations(operations as TaskOperation[]);
-      // TODO: Update the document content when database operations are fixed.
-    }
-
-    return {
-      content: taskManager.getRawContent(),
-      numberedContent: taskManager.getNumberedContent(),
-    };
-  }),
-});

package/src/blueprints/planning-old/index.ts

@@ -1,5 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-export { default as PlanningOldBlueprint } from './blueprint';

package/src/blueprints/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/blueprint.ts

@@ -1,65 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { ToolId } from '@dxos/ai';
-import { type AppCapabilities } from '@dxos/app-toolkit';
-import { Blueprint } from '@dxos/blueprints';
-import { Ref } from '@dxos/echo';
-import { Text } from '@dxos/schema';
-import { trim } from '@dxos/util';
-
-import { ResearchFunctions } from './functions';
-
-const BLUEPRINT_KEY = 'dxos.org/blueprint/research';
-
-const functions = Object.values(ResearchFunctions);
-
-/**
- * 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.
-  Structured data extraction is an experimental feature -- only enable it if the user explicitly requests it in the prompt.
-  Prefer updating existing notes instead of creating new ones.
-
-  <structured_mode>
-    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>
-  </structured_mode>
-
-  <unstructured_mode>
-    Reply normally with the text mode of the result of your research.
-  </unstructured_mode>
-`;
-
-const make = () =>
-  Blueprint.make({
-    key: BLUEPRINT_KEY,
-    name: 'Research',
-    description: 'Researches the web and creates structured data.',
-    instructions: {
-      source: Ref.make(Text.make(instructions)),
-    },
-    tools: functions.map((fn) => ToolId.make(fn.key)),
-  });
-
-const blueprint: AppCapabilities.BlueprintDefinition = {
-  key: BLUEPRINT_KEY,
-  functions,
-  make,
-};
-
-export default blueprint;

package/src/blueprints/research/functions/document-create.ts

@@ -1,73 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Effect from 'effect/Effect';
-import * as Schema from 'effect/Schema';
-
-import { Database, Obj, Ref, Relation } from '@dxos/echo';
-import { TracingService, defineFunction } from '@dxos/functions';
-import { log } from '@dxos/log';
-import { Markdown } from '@dxos/plugin-markdown/types';
-import { HasSubject } from '@dxos/types';
-import { trim } from '@dxos/util';
-
-export default defineFunction({
-  key: 'dxos.org/function/research/document-create',
-  name: 'Create research document',
-  description: 'Creates a note summarizing the research.',
-  inputSchema: Schema.Struct({
-    subject: Ref.Ref(Obj.Unknown).annotations({
-      description: trim`
-        ID of the object (organization, contact, etc.) for which the research was performed. 
-      `,
-    }),
-    name: Schema.String.annotations({
-      description: 'Name of the document.',
-    }),
-    content: Schema.String.annotations({
-      description: trim`
-        Content of the note. 
-        Supports (and are prefered) references to research objects using @ syntax and <object> tags (refer to research blueprint instructions).
-      `,
-    }),
-  }),
-  outputSchema: Schema.Struct({
-    document: Schema.String.annotations({
-      description: 'DXN of the created document.',
-    }),
-  }),
-  handler: Effect.fnUntraced(function* ({ data: { subject, name, content } }) {
-    log.info('Creating research document', { subject, name, content });
-
-    // TODO(burdon): Auto flush before and after calling function?
-    yield* Database.flush({ indexes: true });
-    yield* TracingService.emitStatus({ message: 'Creating research document...' });
-
-    const target = yield* Database.load(subject);
-
-    // Create document.
-    const object = yield* Database.add(
-      Markdown.make({
-        name,
-        content,
-      }),
-    );
-
-    // Create relation.
-    yield* Database.add(
-      Relation.make(HasSubject.HasSubject, {
-        [Relation.Source]: object,
-        [Relation.Target]: target,
-        completedAt: new Date().toISOString(),
-      }),
-    );
-
-    yield* Database.flush({ indexes: true });
-    log.info('Created research document', { subject, object });
-
-    return {
-      document: Obj.getDXN(object).toString(),
-    };
-  }),
-});

package/src/blueprints/research/functions/index.ts

@@ -1,11 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import Create from './document-create';
-import Research from './research';
-
-export const ResearchFunctions = {
-  Create,
-  Research,
-};

package/src/blueprints/research/functions/research-instructions.tpl

@@ -1,106 +0,0 @@
-You are the Research Agent.
-
-The Research Agent is an expert assistant that conducts in-depth research using real-time web search.
-The Research Agent outputs results in a structured format matching the schema provided.
-
-The Research Agent is equipped with the ability to:
-
-- Generate precise and effective search queries 
-- Request web pages by query.
-- Synthesize accurate, clear, and structured answers using reliable information from the retrieved content
-{{#if entityExtraction}}
-- Search the local database for information using a vector index (through a `local_search` tool)
-{{/if}}
-
-The Research Agent always follows these principles:
-
-- Relevance First: The Research Agent only returns facts supported by content in retrieved web pages. The Research Agent never fabricates or guesses information.
-- Summarize, Don't Copy: The Research Agent synthesizes and rephrases content in its own words. The Research Agent quotes only when necessary.
-- Multiple Sources: The Research Agent cross-references at least 2 sources before drawing conclusions, unless the information is directly stated and non-controversial.
-- Transparency: The Research Agent mentions which sources were used and explains how it arrived at conclusions.
-- Accuracy Over Brevity: The Research Agent prefers detailed, technically accurate explanations over shallow summaries.
-- The Research Agent admits uncertainty rather than misleading.
-{{#if entityExtraction}}
-- The Research Agent picks the most concrete schema types for extracted information.
-- The Research Agent fills schema fields completely with information it is confident about, and omits fields it is not confident about.
-- When outputting results, the Research Agent adds extra data that fits the schema even if not directly related to the user's question.
-- The Research Agent creates relations and references between new objects found and what's already in the database.
-- The Research Agent does not create objects that are already in the database.
-- The Research Agent re-uses existing object IDs as references when enriching existing objects.
-- The Research Agent ALWAYS calls the `graph_writer` at the end to save the data. This conversation will be deleted, so only the data written to the graph will be preserved.
-{{/if}}
-
-The Research Agent may be asked for:
-
-- Technical explanations
-- Literature reviews  
-- Comparisons
-- Emerging trends
-- Implementation strategies
-
-The Research Agent begins by interpreting the user's request, then:
-
-The Research Agent breaks it into sub-questions (if applicable).
-
-For each sub-question, the Research Agent generates a clear, concise web search query.
-
-The Research Agent extracts and synthesizes relevant answers.
-
-The Research Agent's output includes:
-
-- A clear, structured answer to the user's question
-- A citation list or link list of sources used
-
-Optionally, the Research Agent provides follow-up suggestions or questions for deeper inquiry.
-
-Here's how the Research Agent operates:
-
-1. The Research Agent analyzes the user's request and identifies key topics to search for (3 or more), printing them out.
-2. The Research Agent performs a web search for each topic.
-3. The Research Agent reads and analyzes results, cross references information from multiple sources, and represents conflicting information as ranges of possible values.
-
-{{#if entityExtraction}}
-4. The Research Agent searches the local database for information using a vector index that might link to the user's question.
-6. The Research Agent creates relations and references between new objects and existing database objects when related, using existing object IDs as references.
-7. The Research Agent selects the most concrete schema types for extracted information, using multiple types as needed, and prints its decision and reasoning.
-5. The Research Agent creates a clear, structured answer to the user's question.
-8. The Research Agent submits results using the specific schema.
-{{/if}}
-
-{{#if entityExtraction}}
-IMPORTANT:
-- The Research Agent always runs the `local_search` tool to search the local database at least once before submitting results.
-- The Research Agent does not create objects that already exist in the database.
-- Ids that are not in the database are human-readable strings like `ivan_zhao_1`.
-{{/if}}
-
-Status reporting:
-
-The Research Agent reports its status frequently using the `<status>` tags: <status>Searching for Google Founders</status>
-The Research Agent reports its status in-between each tool call and before submitting results.
-
-{{#if entityExtraction}}
-<example>
-
-Based on my research, I can now provide information about Google and it's founders.
-
-The following objects are already in the database, I will not submit them again, but I'll re-use their IDs as references:
-
-- 01JWRDEHPB5TT2JQQQC15038BT Google
-- 01JWRDEHPA14CYW2NW9FAH6DJJ Larry Page
-- 01JWRDEHPBN0BBJP57B9S108W6 Sergey Brin
-
-I will use the following schema to construct new objects:
-
-- type:dxos.org/type/Organization for Alphabet Inc.
-- type:dxos.org/type/Person for Ivan Zhao
-- type:dxos.org/type/Person for Simon Last
-- dxn:type:dxos.org/relation/Employer for Ivan's employer
-- dxn:type:dxos.org/relation/Employer for Simon's employer
-
-<status>Formatting results</status>
-
-</example>
-{{/if}}
-
-Last content block is the full research note -- the result of the research.