still_point

Instructions

Implementation Reference

• src/mcp/tools/stats.ts:64-76 (handler)

  The 'makeTool' generic factory that creates the handler for 'still_point' (and other stat tools). The handler sets petBuddyStreak=0, updates lastToolCalled, then delegates to 'respond()' with the PATIENCE stat and 'still' context.

  function makeTool(
    toolName: string,
    description: string,
    stat: keyof typeof STAT_TOOL_RESPONSES,
    context: string,
  ): void {
    dynamicTools.set(toolName, {
      tool: { name: toolName, description, inputSchema },
      handler: async (args) => {
        S.petBuddyStreak = 0;
        S.lastToolCalled = toolName;
        return respond(stat, context, args);
      },

• src/mcp/tools/stats.ts:48-62 (handler)

  The 'respond' function that executes the actual tool logic for 'still_point'. It picks a random quip from STAT_TOOL_RESPONSES['PATIENCE']['still'] (the 'still' context responses like 'Stop moving. Let the problem come to you.'), optionally appends a target, and wraps the result in buddy display tags.

  function respond(
    stat: keyof typeof STAT_TOOL_RESPONSES,
    context: string,
    args: Record<string, unknown>,
  ): string {
    const buddy = S.currentBuddy;
    if (!buddy) return 'No buddy active. Initialize a buddy first.';
    const pool = STAT_TOOL_RESPONSES[stat][context] ?? STAT_TOOL_RESPONSES[stat]['general']!;
    const quip = pick(pool);
    const target = args['target'] as string | undefined;
    const output = target
      ? `${buddy.name}: "${quip}"\n\n*target: ${target}*`
      : `${buddy.name}: "${quip}"`;
    return wrapBuddyDisplay(output);
  }

• src/mcp/tools/stats.ts:119-124 (registration)

  Registration of 'still_point' tool: calls makeTool with name='still_point', description for the PATIENCE stat, context='still'.

  makeTool(
    'still_point',
    '[Buddy Tool] Stop. Be still. Let the answer come to you. (global)',
    'PATIENCE',
    'still',
  );

• src/mcp/tools/stats.ts:39-42 (schema)

  Input schema for 'still_point' (and all stat tools) — accepts an optional 'target' string parameter.

  const inputSchema = {
    type: 'object' as const,
    properties: { target: { type: 'string', description: 'The file or code to look at' } },
  };

• src/personalities.ts:142-148 (helper)

  The 'still' response pool for the PATIENCE stat — these are the quips randomly selected when 'still_point' is called. They are part of STAT_TOOL_RESPONSES['PATIENCE']['still'].

    still: [
      'Stop moving. Let the problem come to you.',
      "Do nothing for 30 seconds. I'll time it.",
      'The answer arrives when you stop looking.',
      "Stillness. Not giving up. There's a difference.",
    ],
  },