Skip to content

A team of long-lived bots for DeepSeek Harness, with main bots, bot-to-bot messages and group chats.

2.8 KB
Raw Blame
// One goal in, one answer out. The plugin runs the ref tools itself and returns
// the step list, so a Bot can hand off a whole web task and still check what happened.
import { runToolLoop } from './loop.js'
import { systemPrompt as refsPrompt, toolDefs as refTools } from './refs.js'

const driverTools = (session, origin, handoffs) => refTools.map(tool => ({
    name: tool.name,
    description: tool.description,
    parameters: tool.parameters,
    execute: async (args) => {
      const value = await tool.execute(args, { session, botId: session.botId, profileDir: session.userDataDir, origin })
      if (tool.name === 'browser_handoff') handoffs.push(typeof value === 'string' ? value : String(value?.text ?? ''))
      return value
    },
  }))

export async function runTask({ session, goal, complete, origin, maxSteps = 8 }) {
  if (typeof complete !== 'function') throw new Error('browser_task needs a Bot session model')
  const handoffs = []
  const result = await runToolLoop({
    tools: driverTools(session, origin, handoffs),
    complete,
    goal,
    system: refsPrompt,
    maxSteps,
  })
  const steps = result.trace.map(step => `${step.name} ${JSON.stringify(step.args)}`).join('\n')
  const text = [
    result.answer || '(no answer)',
    '',
    // The outer Bot needs the handoff instructions even if the nested model omits them.
    ...(handoffs.length > 0 ? ['Handoffs:', handoffs.join('\n'), ''] : []),
    result.stopped === 'max-steps' ? `Stopped after ${result.steps} steps.` : `Finished in ${result.steps} steps.`,
    'Steps:',
    steps || '(none)',
  ].join('\n')
  return { ...result, text }
}

export const id = 'task'
export const label = 'Whole task'
export const systemPrompt = 'Call browser_task once with the user\'s web goal. The tool runs the browser and returns the answer plus the steps it took. Posting, uploading, downloading, and deleting may need approval; deletes require a second confirmed click after checking the snapshot. Payments, logins, and captchas go to the user via browser_handoff. If an action result is unknown, check with browser_snapshot and never repeat it blindly. Do not browse with any other tool.'

export const toolDefs = [
  {
    name: 'browser_task',
    needsBrowser: true,
    description: 'Run a whole web task in this Bot\'s browser: open pages, read them, click, and type. Returns the answer and the steps. Login, payment, and captcha are handed to the user.',
    parameters: {
      goal: { type: 'string', required: true, description: 'What to do on the web, including the address when you know it' },
    },
    async execute(args, ctx) {
      const result = await runTask({
        session: ctx.session,
        goal: String(args.goal ?? ''),
        complete: ctx.complete,
        origin: ctx.origin,
      })
      return { text: result.text }
    },
  },
]

export const tools = toolDefs