get_technical_specs

Instructions

Implementation Reference

• src/content.ts:892-963 (helper)

  The `technicalSpecs` constant containing the tool's response data — full technical specifications including input formats, AI processing details, output quality, credit system, and platform info.

  const technicalSpecs = {
    title: "Echo3s Technical Specifications",
    input: {
      supported_formats: "PDF (text-based with selectable text)",
      max_file_size: "50MB",
      convertible_formats: "EPUB, MOBI, DOCX, AZW — convert to PDF using Calibre (free, open-source)",
      text_requirements: "PDF must contain selectable text (not scanned images). OCR'd PDFs may work but quality varies.",
      language_support: "Any language supported by ElevenLabs (29 languages). Primary: English, Arabic (with RTL), Dutch.",
      encoding: "UTF-8 text extraction. Full Unicode support including Arabic, CJK, and diacritics.",
    },
    ai_processing: {
      character_detection: {
        engine: "Google Gemini AI",
        capabilities: [
          "Automatic character identification from narrative text",
          "Dialogue attribution — assigns speech to the correct character",
          "Narration vs dialogue classification",
          "Chapter boundary detection",
          "Emotional context per segment",
        ],
        speed: "1–3 minutes per chapter",
      },
      voice_matching: {
        algorithm: "Weighted scoring: gender (40pts), language (30pts), age (15pts), personality (15pts)",
        total_voices: "50+ premium voices",
        provider: "ElevenLabs",
        customization: "Full manual override — swap any voice assignment in the Studio editor",
        characteristics: ["Gender (Male/Female/Neutral)", "Age (Young/Middle-aged/Elder/Child)", "Accent (American/British/Australian/Indian/Irish/South African/Arabic MSA/Gulf/Egyptian/Dutch)", "Tone (Calm/Gentle/Strong/Deep/Raspy/Bright/Cheerful/Energetic/Serious/Formal)"],
      },
    },
    output: {
      audio_format: "MP3",
      quality: "High-quality ElevenLabs studio voices",
      loudness_normalization: "EBU R128 standard (-16 LUFS) — broadcast-grade loudness",
      download_options: ["Full audiobook as single MP3", "Per-chapter MP3 files"],
      streaming: "Available via Echo3s marketplace (echo3s.io)",
    },
    generation: {
      speed: "30–60 minutes for a 200-page novel (fully automated after setup)",
      active_time: "~4 minutes of author time (upload, review, generate). Rest is automated.",
      segment_regeneration: "Individual lines or paragraphs can be regenerated without redoing full chapters",
      notification: "Email notification when audiobook generation is complete",
    },
    credit_system: {
      unit: "1 credit = 1 character of generated audio",
      average_per_page: "~650 credits",
      examples: [
        { pages: 50, credits: "~32,500", plan: "Creator ($29/mo)" },
        { pages: 100, credits: "~65,000", plan: "Creator ($29/mo) or Pro ($99/mo)" },
        { pages: 200, credits: "~130,000", plan: "Pro ($99/mo)" },
        { pages: 300, credits: "~195,000", plan: "Pro ($99/mo)" },
        { pages: 400, credits: "~260,000", plan: "Business ($249/mo) or Pro + top-up" },
        { pages: 800, credits: "~520,000", plan: "Business ($249/mo)" },
      ],
      billing: "Credits reset monthly on subscription plans. Top-up packs never expire.",
    },
    platform: {
      web_app: "https://author.echo3s.io",
      marketplace: "https://echo3s.io",
      languages_ui: ["English", "Arabic"],
      browser_support: "Modern browsers (Chrome, Firefox, Safari, Edge)",
      mobile: "Responsive web app — works on mobile browsers",
      api: "Publisher API on roadmap — not yet available. Contact hello@echo3s.io for enterprise needs.",
    },
    security: {
      auth: "Supabase Auth (email/password, OAuth)",
      payment: "Stripe (PCI-DSS compliant)",
      data: "Manuscripts processed for audiobook generation. Authors retain 100% ownership of content and output.",
      hosting: "Supabase (PostgreSQL), Netlify (frontend), Cloudflare (CDN/Workers)",
    },
    cta: "Technical questions? Email hello@echo3s.io or start free at https://author.echo3s.io",
  };

• src/content.ts:1053-1059 (registration)

  Registration of 'get_technical_specs' tool in the TOOL_DEFS array — links the tool name to its description, empty input schema, and a content function that returns the technicalSpecs data.

  {
    name: "get_technical_specs",
    description:
      "Get Echo3s technical specifications — supported formats, AI processing details, output quality, credit system, and platform info",
    inputSchema: { type: "object", properties: {}, required: [] },
    content: () => technicalSpecs,
  },

• src/index.ts:13-21 (handler)

  Handler registration for all tools (including get_technical_specs) — iterates TOOL_DEFS and registers each with server.tool(), invoking tool.content() on call.

  for (const tool of TOOL_DEFS) {
    server.tool(tool.name, tool.description, {}, async () => ({
      content: [
        {
          type: "text" as const,
          text: JSON.stringify(tool.content(), null, 2),
        },
      ],
    }));

• src/worker.ts:12-19 (handler)

  Worker handler for all tools including get_technical_specs — transforms ToolDef into a WorkerToolDef with a handler that calls def.content(args).

  function defToWorkerTool(def: ToolDef): WorkerToolDef {
    return {
      description: def.description,
      inputSchema: def.inputSchema,
      handler: (args?: any) => [
        { type: "text", text: JSON.stringify(def.content(args)) },
      ],
    };